事件流包含捕獲、目標、冒泡三階段。理解並正確控制事件傳播,是避免重複觸發、實現事件代理、構建可維護交互系統的關鍵。本文深度解析機制、API 差異、實戰模式與現代最佳實踐。
// 捕獲階段:window -> document -> html -> body -> ... -> 目標父級
// 目標階段:目標元素
// 冒泡階段:目標父級 -> ... -> body -> html -> document -> window
默認監聽器註冊在冒泡階段;addEventListener(type, handler, {capture: true}) 註冊在捕獲階段。
| 方法 | 影響範圍 | 用例 |
|---|---|---|
event.stopPropagation() | 阻止**當前事件**在**當前階段**繼續傳播(捕獲/冒泡),同元素其他監聽器仍執行 | 組件內部阻止向外冒泡 |
event.stopImmediatePropagation() | 阻止**當前事件**在**所有階段**傳播,**且阻止同元素同類型其他監聽器**執行 | 插件系統優先級、阻止默認行為後續處理 |
event.preventDefault() | 取消瀏覽器**默認行為**(跳轉、提交、選中、右鍵菜單),**不影響傳播** | 表單驗證、自定義右鍵菜單、阻止鏈接跳轉 |
// ❌ 差:為每個 li 綁定監聽器
document.querySelectorAll('#list li').forEach(li => li.addEventListener('click', handler));
// ✅ 好:父元素單一監聽器
document.getElementById('list').addEventListener('click', e => {
const li = e.target.closest('li');
if (!li || !e.currentTarget.contains(li)) return; // 防止事件來自嵌套列表
handler(li, e);
});
優點:動態新增子元素無需重新綁定、內存佔用少、邏輯集中。
class Dropdown {
constructor(el) {
this.el = el;
this.trigger = el.querySelector('.trigger');
this.menu = el.querySelector('.menu');
this._bind();
}
_bind() {
this.trigger.addEventListener('click', e => {
e.stopPropagation(); // 阻止冒泡到 document 關閉邏輯
this.toggle();
});
document.addEventListener('click', () => this.close()); // 點擊外部關閉
this.menu.addEventListener('click', e => e.stopPropagation()); // 菜單內點擊不關閉
}
toggle() { this.el.classList.toggle('open'); }
close() { this.el.classList.remove('open'); }
}
const controller = new AbortController();
el.addEventListener('click', handler, { signal: controller.signal });
// 組件銷毀時
controller.abort(); // 自動移除所有關聯監聽器
stopPropagation 導致上層組件無法感知交互(如統計埋點、全局快捷鍵)。onclick="..." 內聯屬性無法使用 stopPropagation,避免使用。e.stopPropagation() 無法阻止傳播到根,需用 e.nativeEvent.stopImmediatePropagation()(不推薦)或架構調整。