DIV CSS 佈局教程網

動態為元素綁定與移除事件:addEventListener 的實戰與陷阱
編輯:關於JavaScript     

專案裡需要動態給元素掛上事件,順手也把 addEventListener 與 removeEventListener 這對 API 弄清楚了。一開始寫得很順利,卻在移除的環節卡住——這個過程本身就很有教學價值。

基本用法

// addEventListener() / removeEventListener() 用於新增與移除事件處理器
// 事件處理器會在其所屬元素的作用域內執行
// 語法:addEventListener(event, function, capture/bubble)
//       removeEventListener(event, function, capture/bubble)
// capture 與 bubble 是 W3C 定義的兩種事件傳遞模式:
//   capture(捕捉):由外而內,從 document 往下走到目標
//   bubble(冒泡):由內而外,先觸發目標再往上回傳
// 參數為布林值,true 代表 capture,false 代表 bubble

function addEvent() {
  var obj = document.getElementById("txtIataCity");
  if (window.addEventListener) {
    // 標準瀏覽器:Mozilla、Netscape、Firefox 等
    // 注意:用 addEventListener 時事件名稱不要加 on
    obj.addEventListener('focus', function () { test('aa'); }, false);
  } else {
    // 舊版 IE:attachEvent 的事件名稱要加 on
    obj.attachEvent('onfocus', function () { test('aa'); });
  }
}

function removeEvent() {
  var obj = document.getElementById("txtIataCity");
  if (window.removeEventListener) {
    obj.removeEventListener('focus', function () { test('aa'); }, false);
  } else {
    obj.detachEvent('onfocus', function () { test('aa'); });
  }
}

問題:移除永遠失敗

頁面載入時呼叫 addEvent,綁定成功;但 removeEvent 無論執行幾次都毫無效果。查了資料才看到關鍵那句話:

透過 addEventListener() 加入的事件,只能透過 removeEventListener() 移除;但用匿名函數加入的事件無法被移除。

問題就出在這裡:function(){test('aa')} 每次求值都是一個全新的函數物件,加入時的那一個與移除時的那一個,參考並不相同,瀏覽器自然找不到要移除的目標。

解法:把函數引用提出來

正確做法是把處理器定義為有名字的函數,加入與移除時傳入同一個參考:

function test(msg) { alert(msg); }

function addEvent() {
  var obj = document.getElementById("txtIataCity");
  if (obj.addEventListener) {
    obj.addEventListener('focus', test, false);
  } else {
    obj.attachEvent('onfocus', test);
  }
}

function removeEvent() {
  var obj = document.getElementById("txtIataCity");
  if (obj.removeEventListener) {
    obj.removeEventListener('focus', test, false);
  } else {
    obj.detachEvent('onfocus', test);
  }
}

如果確實需要帶參數,可以用閉包產生處理器並保留參考:

function makeHandler(msg) {
  return function () { test(msg); };
}

var handler = makeHandler('aa');
obj.addEventListener('focus', handler, false);
// 稍後移除時使用同一個 handler
obj.removeEventListener('focus', handler, false);

實務上的建議

這段經歷說明了一件事:原生事件 API 雖然直接,但容易在細節上踩坑。專案若已引入 jQuery,直接用 bind() / unbind()(或後續版本的 on() / off())會輕ancing許多,因為框架內部幫你維護了處理器與命名空間的對應關係。現代專案若使用 ES2015 之後的環境,也可以考慮 AbortController 搭配 addEventListener(..., { signal }),一次就能批次取消多個監聽器。

核心觀念只有一句:要能移除,就必須持有同一個函數參考。把這句話記住,這類問題就不會再困住你。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved