歡迎來到合肥浪訊網(wǎng)絡科技有限公司官網(wǎng)
  咨詢服務熱線:400-099-8848

如何移除通過$on方法動態(tài)添加的事件監(jiān)聽器?

發(fā)布時間:2025-11-08 文章來源:本站  瀏覽次數(shù):170
在 Vue 中,通過 $on 方法動態(tài)添加的事件監(jiān)聽器,需要使用 $off 方法來移除。核心原則是:$off 的參數(shù)必須與 $on 完全匹配(事件名和回調(diào)函數(shù)引用一致)。以下是具體實現(xiàn)方法及場景示例:

一、核心用法:$off 移除特定事件監(jiān)聽器

$on 用于綁定事件,$off 用于移除,兩者參數(shù)對應關系如下:
$on 綁定方式 $off 移除方式 說明
$on('eventName', handler) $off('eventName', handler) 移除指定事件的指定回調(diào)
$on('eventName', handler) $off('eventName') 移除指定事件的所有回調(diào)
$on('eventName', handler) $off() 移除組件所有事件的所有回調(diào)

二、具體場景示例

1. 移除指定事件的指定回調(diào)函數(shù)

這是常用的場景,需確保 $off 的回調(diào)函數(shù)與 $on 引用一致(不能用匿名函數(shù))。
vue
<script>
export default {
  created() {
    // 1. 定義具名回調(diào)函數(shù)(確保引用唯一)
    this.handleClick = () => {
      console.log('自定義事件被觸發(fā)');
    };

    // 2. 用 $on 綁定事件
    this.$on('custom-click', this.handleClick);
  },
  mounted() {
    // 模擬事件觸發(fā)
    this.$emit('custom-click'); // 輸出:自定義事件被觸發(fā)
  },
  beforeDestroy() {
    // 3. 用 $off 移除指定事件的指定回調(diào)(關鍵步驟)
    this.$off('custom-click', this.handleClick);
  }
};
</script>

2. 移除指定事件的所有回調(diào)函數(shù)

若一個事件綁定了多個回調(diào),可通過 $off('eventName') 一次性移除所有。
vue
<script>
export default {
  created() {
    // 綁定多個回調(diào)到同一事件
    this.$on('custom-event', () => console.log('回調(diào)1'));
    this.$on('custom-event', () => console.log('回調(diào)2'));
  },
  mounted() {
    this.$emit('custom-event'); // 輸出:回調(diào)1、回調(diào)2
  },
  beforeDestroy() {
    // 移除 custom-event 的所有回調(diào)
    this.$off('custom-event');
  }
};
</script>

3. 移除組件的所有事件監(jiān)聽器

若需清空組件上所有通過 $on 綁定的事件,直接調(diào)用 $off() 即可(無參數(shù))。
vue
<script>
export default {
  created() {
    this.$on('event1', () => {});
    this.$on('event2', () => {});
  },
  beforeDestroy() {
    // 移除所有事件的所有回調(diào)
    this.$off();
  }
};
</script>

4. 在子組件中移除父組件綁定的事件

父組件通過 v-on 綁定子組件的自定義事件,本質(zhì)是子組件內(nèi)部通過 $on 處理,子組件可在卸載時用 $off 移除。
vue
<!-- 子組件 Child.vue -->
<script>
export default {
  created() {
    // 父組件綁定的 @child-event 會被 Vue 內(nèi)部轉為 $on
    // 子組件可通過 $off 移除(需知道事件名和回調(diào))
    this.$on('child-event', this.handleChildEvent);
  },
  methods: {
    handleChildEvent() {
      console.log('子組件事件觸發(fā)');
    }
  },
  beforeDestroy() {
    this.$off('child-event', this.handleChildEvent);
  }
};
</script>

三、避坑指南

1. 匿名函數(shù)無法移除

$on 若使用匿名函數(shù)綁定,$off 無法找到相同引用,導致移除失敗。
javascript
運行
// 錯誤示例:匿名函數(shù)無法移除
this.$on('custom-event', () => console.log('匿名回調(diào)'));
this.$off('custom-event', () => console.log('匿名回調(diào)')); // 無效,引用不同

// 正確示例:用具名函數(shù)
this.handleEvent = () => console.log('具名回調(diào)');
this.$on('custom-event', this.handleEvent);
this.$off('custom-event', this.handleEvent); // 有效

2. $off 參數(shù)必須與 $on 完全匹配

若 $on 綁定了多個回調(diào),$off('eventName', handler) 僅移除指定回調(diào),其他回調(diào)仍有效;若需移除所有,需用 $off('eventName')

3. 組件卸載時自動清理

Vue 組件卸載時,會自動移除所有通過 $on 綁定的事件監(jiān)聽器,因此若僅需在組件銷毀時移除,無需手動調(diào)用 $off。但如果組件未銷毀(如隱藏而非銷毀),則需手動移除。

4. 注意事件作用域

$on / $off 綁定的是組件實例的事件,而非 DOM 事件。若需移除 DOM 事件,仍需用 removeEventListener。

總結

移除 $on 動態(tài)添加的事件監(jiān)聽器,核心是:
  1. 用 $off 方法,參數(shù)與 $on 完全匹配(事件名 + 回調(diào)函數(shù)引用);
  2. 避免使用匿名函數(shù),改用具名函數(shù)確保引用一致;
  3. 組件卸載時 Vue 會自動清理,無需手動 $off(除非組件未銷毀);
  4. 區(qū)分組件實例事件($on / $off)和 DOM 事件(addEventListener / removeEventListener)。

上一條:如何移除組件的所有事件監(jiān)...

下一條:網(wǎng)站的規(guī)劃能夠從以下4點...