事件監聽是前端互動核心。addEventListener 第三參數在不同瀏覽器預設值不同、removeEventListener 需精確匹配參數、IE 歷史差異、記憶體洩漏風險。本文系統整理標準用法、陷阱避坑、現代最佳實務與封裝工具。
target.addEventListener(type, listener, options);
| 形式 | 支援 | 說明 |
|---|---|---|
useCapture (布林) | 所有現代瀏覽器 + IE9+ | true=捕獲階段, false=冒泡階段 (預設) |
options 物件 | Chrome 55+, Firefox 59+, Safari 11+ | {capture, once, passive, signal} |
element.addEventListener('click', handler, {
capture: false, // 捕獲階段觸發
once: false, // true: 執行一次後自動移除
passive: false, // true: 永不呼叫 preventDefault(),瀏覽器可優化滾動
signal: abortSignal // AbortController 信號,統一移除
});
// ❌ 錯誤:第三參數不一致
element.addEventListener('click', handler, true); // 捕獲
element.removeEventListener('click', handler, false); // 冒泡 - 無法移除!
// ✅ 正確:參數完全一致
element.addEventListener('click', handler, true);
element.removeEventListener('click', handler, true); // 成功移除
// ✅ 現代寫法:使用 options 物件
const options = { capture: true, passive: true };
element.addEventListener('click', handler, options);
element.removeEventListener('click', handler, options); // 物件引用相同或屬性相同
// 統一封裝:支援 IE8+
function addEvent(element, type, handler, options = {}) {
const capture = !!options.capture;
const once = !!options.once;
const passive = !!options.passive;
if (element.addEventListener) {
// 現代瀏覽器
const opts = { capture, once, passive };
element.addEventListener(type, handler, opts);
return () => element.removeEventListener(type, handler, opts);
} else if (element.attachEvent) {
// IE8-
const wrapped = function(e) {
e = e || window.event;
e.target = e.srcElement;
e.preventDefault = () => e.returnValue = false;
e.stopPropagation = () => e.cancelBubble = true;
return handler.call(element, e);
};
element.attachEvent('on' + type, wrapped);
return () => element.detachEvent('on' + type, wrapped);
} else {
// 極舊瀏覽器 fallback
element['on' + type] = handler;
return () => element['on' + type] = null;
}
}
// 使用:回傳移除函式
const removeClick = addEvent(btn, 'click', () => console.log('clicked'), { once: true });
// 手動移除
removeClick();
const controller = new AbortController();
const { signal } = controller;
// 批次綁定多個事件
['click', 'keydown', 'mouseover'].forEach(type => {
element.addEventListener(type, handler, { signal, passive: true });
});
// 一次性全部移除
controller.abort();
| 洩漏來源 | 原因 | 解決 |
|---|---|---|
| 匿名函式無法移除 | el.addEventListener('click', () => {}) 無引用 | 命名函式或保存引用 |
| 元素移除未解綁 | DOM 移除但監聽器殘留 | 元素移除前調用 removeEventListener |
| 閉包捕獲大量資料 | 監聽器閉包持有大物件 | 弱引用 WeakMap / 手動清理 |
| 重複綁定 | 元件重複掛載未清理 | 掛載前清理、使用 once、AbortController |
// 捲動容器內的 touchstart,預設 passive=true (現代瀏覽器)
container.addEventListener('touchstart', handler, { passive: true });
// 內部不可呼叫 e.preventDefault(),否則瀏覽器忽略並警告
// 需要 preventDefault 時必須顯式 passive: false
container.addEventListener('touchstart', e => {
if (shouldPrevent) e.preventDefault();
}, { passive: false });
function normalizeEvent(e) {
e = e || window.event;
e.target = e.target || e.srcElement;
e.currentTarget = e.currentTarget || e.target; // 近似
e.preventDefault = e.preventDefault || function() { this.returnValue = false; };
e.stopPropagation = e.stopPropagation || function() { this.cancelBubble = true; };
e.which = e.which || e.keyCode; // 鍵盤
e.pageX = e.pageX || e.clientX + document.documentElement.scrollLeft;
e.pageY = e.pageY || e.clientY + document.documentElement.scrollTop;
return e;
}
// 使用
element.addEventListener('click', function(e) {
e = normalizeEvent(e);
// 統一使用 e.target, e.preventDefault(), e.stopPropagation()
});
// 自訂事件
const event = new CustomEvent('user-login', {
detail: { userId: 123, token: 'abc' },
bubbles: true,
cancelable: true
});
document.dispatchEvent(event);
// 監聽
document.addEventListener('user-login', e => {
console.log(e.detail.userId);
});
// 事件委派:父層監聽子元素事件
document.body.addEventListener('click', e => {
const btn = e.target.closest('[data-action]');
if (!btn) return;
const action = btn.dataset.action;
const payload = JSON.parse(btn.dataset.payload || '{}');
switch (action) {
case 'delete': deleteItem(payload.id); break;
case 'edit': editItem(payload.id); break;
}
});
onClick 自動綁定、清理,勿混用原生 addEventListener 除非 useEffect 清理函式中@click 編譯為原生監聽,組件銷毀自動移除connectedCallback 綁定、disconnectedCallback 清理事件監聽核心在於:參數完全對稱 (add/remove 同參數)、選項物件現代化 (once/passive/signal/AbortController)、記憶體洩漏預防 (命名函式、清理時機、弱引用)。理解捕獲/冒泡、事件物件標準化、IE 歷史差異,能寫出健壯、高效、可維護的事件處理代碼。