element.addEventListener(event, handler, useCapture);
event:事件名(不含 "on",如 "click")handler:處理函數useCapture:布爾值,決定監聽階段
true:捕獲階段(由外向內)false(默認):冒泡階段(由內向外)<div id="outDiv">
<div id="middleDiv">
<div id="inDiv">點擊這裡</div>
</div>
</div>
| outDiv | middleDiv | inDiv | 觸發順序 | 規律 |
|---|---|---|---|---|
| false | false | false | inDiv → middleDiv → outDiv | 全同階段:內→外(冒泡)或 外→內(捕獲) |
| true | true | true | outDiv → middleDiv → inDiv | |
| false | true | false | middleDiv → inDiv → outDiv | 混合:true 先於 false;同階段按層級序 |
| true | false | false | outDiv → inDiv → middleDiv | 捕獲優先,同階段按層級 |
| false | false | true | inDiv → outDiv → middleDiv |
useCapture=true 的監聽器,總在 false 之前觸發true 時,外層先於內層false 時,內層先於外層element.addEventListener("click", handler, {
capture: true, // 替代 useCapture
once: true, // 執行一次後自動移除
passive: true // 告知瀏覽器不會調用 preventDefault,優化滾動性能
});
capture: true 確保父層先處理,防止子組件 stopPropagation 影響全局邏輯passive: true 用於 touch/scroll 事件,瀏覽器可並行處理once: true 替代手動 removeEventListener❌ "useCapture 控制是否冒泡" — 錯誤,它控制的是監聽階段。阻止冒泡用
event.stopPropagation()。❌ "捕獲階段不能取消" — 錯誤,捕獲階段同樣可調用
preventDefault()和stopPropagation()。