Skip to content
⚠️ This article was written in 2018. Some content may be outdated.

Vue 深度監聽和監聽數組

Vue 的響應式系統對對象屬性和數組有一些特殊限制,搞清楚這些才能正確用 watch

監聽對象:deep 選項

javascript
export default {
  data() {
    return {
      form: {
        name: "",
        age: 0,
        address: {
          city: "",
          street: "",
        },
      },
    };
  },
  watch: {
    // 默認:只監聽 form 引用變化(換了一個新對象才觸發)
    form(newVal, oldVal) {
      // form.name 變了不會觸發
    },

    // deep: true:監聽內部所有屬性的變化
    form: {
      handler(newVal) {
        console.log("表單變了", newVal);
      },
      deep: true,
    },
  },
};

deep 的代價:會遍歷對象所有屬性,性能開銷大。如果只關心某個屬性,直接監聽那個路徑:

javascript
watch: {
  // 監聽嵌套屬性(用字符串路徑)
  'form.address.city'(newVal) {
    console.log('城市變了', newVal)
  }
}

Vue 對數組的限制

Vue 2 不能檢測以下數組變動:

javascript
// ❌ Vue 檢測不到
this.list[0] = "new value"; // 直接用索引賦值
this.list.length = 0; // 直接修改 length

// ✅ 正確的做法
this.$set(this.list, 0, "new value"); // 或者:
Vue.set(this.list, 0, "new value");

this.list.splice(0, this.list.length); // 清空數組

Vue 封裝了這些數組方法,使用它們可以觸發更新:

javascript
// 這些方法 Vue 做了封裝,會觸發視圖更新
this.list.push(item);
this.list.pop();
this.list.shift();
this.list.unshift(item);
this.list.splice(index, 1);
this.list.sort();
this.list.reverse();

// 這些不會觸發(返回新數組)→ 需要賦值回去
this.list = this.list.filter((x) => x > 1);
this.list = this.list.map((x) => x * 2);
this.list = this.list.concat([4, 5]);

監聽數組

javascript
watch: {
  // 監聽數組,直接寫(不需要 deep,數組 push/pop 等能被檢測到)
  list(newVal) {
    console.log('list 變了', newVal)
  },

  // 如果要監聽數組裏每個對象的屬性變化,需要 deep
  userList: {
    handler(newVal) {
      console.log('user 屬性變化')
    },
    deep: true
  }
}

immediate:初始化時立即執行

javascript
watch: {
  userId: {
    handler(id) {
      this.loadUserData(id)
    },
    immediate: true  // 組件創建時就執行一次,而不是等數據變化
  }
}

等價於:

javascript
created() {
  this.loadUserData(this.userId)
},
watch: {
  userId(id) {
    this.loadUserData(id)
  }
}

immediate: true 更簡潔。

小結

  • 監聽對象屬性變化:deep: true,但有性能開銷
  • 監聽特定嵌套屬性:直接寫字符串路徑,比 deep 更高效
  • Vue 2 數組限制:索引賦值和 length 變化檢測不到,用 $set 或數組方法
  • immediate: true:初始化時立即執行,避免寫重複代碼

MIT Licensed