const EventUtil = {
// 事件 ID 生成器(用於去重)
_uid: 1,
_handlers: new WeakMap(), // 元素 -> {type: [{id, fn, wrapper}]}
add(element, type, fn) {
if (!element || typeof fn !== 'function') return;
// 獲取或創建元素的處理器存儲
let elemData = this._handlers.get(element);
if (!elemData) { elemData = {}; this._handlers.set(element, elemData); }
let typeHandlers = elemData[type];
if (!typeHandlers) { typeHandlers = []; elemData[type] = typeHandlers; }
// 去重:同一元素、同一類型、同一函數引用不重複添加
if (typeHandlers.some(h => h.fn === fn)) return;
const id = this._uid++;
let wrapper;
if (element.addEventListener) {
// W3C 標準
wrapper = function(event) {
// 修正 event 物件
event = event || window.event;
event.target = event.target || event.srcElement;
event.preventDefault = event.preventDefault || function() { this.returnValue = false; };
event.stopPropagation = event.stopPropagation || function() { this.cancelBubble = true; };
// 統一 this 指向元素
return fn.call(element, event);
};
element.addEventListener(type, wrapper, false);
} else if (element.attachEvent) {
// IE 兼容
wrapper = function(event) {
event = event || window.event;
event.target = event.target || event.srcElement;
event.preventDefault = function() { this.returnValue = false; };
event.stopPropagation = function() { this.cancelBubble = true; };
return fn.call(element, event);
};
element.attachEvent('on' + type, wrapper);
} else {
// DOM 0 級降級
element['on' + type] = wrapper;
}
typeHandlers.push({id, fn, wrapper});
},
remove(element, type, fn) {
if (!element) return;
const elemData = this._handlers.get(element);
if (!elemData) return;
const typeHandlers = elemData[type];
if (!typeHandlers) return;
const idx = typeHandlers.findIndex(h => h.fn === fn);
if (idx === -1) return;
const {wrapper} = typeHandlers[idx];
if (element.removeEventListener) {
element.removeEventListener(type, wrapper, false);
} else if (element.detachEvent) {
element.detachEvent('on' + type, wrapper);
} else {
element['on' + type] = null;
}
typeHandlers.splice(idx, 1);
if (typeHandlers.length === 0) delete elemData[type];
},
// 移除元素所有事件(防止內存洩漏)
purge(element) {
if (!element) return;
const elemData = this._handlers.get(element);
if (!elemData) return;
for (const type in elemData) {
elemData[type].forEach(({wrapper}) => {
if (element.removeEventListener) element.removeEventListener(type, wrapper, false);
else if (element.detachEvent) element.detachEvent('on' + type, wrapper);
else element['on' + type] = null;
});
}
this._handlers.delete(element);
}
};
// 使用
EventUtil.add(btn, 'click', handler);
EventUtil.remove(btn, 'click', handler);
EventUtil.purge(container); // 移除容器及所有後代事件(配合 MutationObserver 自動清理)
| 問題 | 解決方案 |
|---|---|
| IE `this` 指向 window | `fn.call(element, event)` 強制綁定 |
| IE 事件對象缺標準屬性 | Wrapper 內補全 `target`、`preventDefault`、`stopPropagation` |
| IE 同類事件倒序執行 | 用陣列存儲處理器,按添加順序迴圈調用(而非依賴瀏覽器) |
| 重複綁定同一函數 | WeakMap + 陣列去重(比較函數引用) |
| 內存洩漏(循環引用) | WeakMap 不阻礙 GC、`purge()` 手動清理、頁面卸載時遍歷清理 |
| 動態添加元素事件綁定 | 事件委派:`parent.addEventListener(type, e => { if(e.target.matches(selector)) handler(e); })` |
element.addEventListener('click', handler, {
capture: false, // 冒泡階段
once: false, // 不自動移除
passive: false, // 不預設 preventDefault(scroll/touch 建議 true)
signal: abortSignal // AbortController 統一取消
});
// 批次移除
const controller = new AbortController();
elements.forEach(el => el.addEventListener('click', handler, {signal: controller.signal}));
controller.abort(); // 一次性移除所有
function delegate(parent, selector, type, handler) {
parent.addEventListener(type, e => {
const target = e.target.closest(selector);
if (target && parent.contains(target)) {
handler.call(target, e);
}
});
}
// 使用
delegate(document.getElementById('list'), 'li', 'click', function(e) {
console.log('點擊:', this.dataset.id);
});
雖然現代瀏覽器已全面支援 `addEventListener`,但理解歷史兼容層封裝原理,有助於維護舊專案、設計健壯的事件系統。核心要點:統一 `this`、修正事件對象、保證執行順序、去重、防洩漏、支援委派。新專案請直接使用原生 API 配合 `AbortController`、`{once:true}`、`{passive:true}` 等現代特性,代碼更簡潔、效能更優。