專案裡需要動態給元素掛上事件,順手也把 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 }),一次就能批次取消多個監聽器。
核心觀念只有一句:要能移除,就必須持有同一個函數參考。把這句話記住,這類問題就不會再困住你。