「取消預設行為」和「阻止事件傳遞」是兩件完全不同的事,卻經常被混為一談,甚至有人以為 return false 同時做了兩件事。本文把這兩個概念分開講清楚。
標準做法是呼叫事件物件的 preventDefault();IE9 之前則是設定 returnValue = false。以下這個 handler 同時用了三種技術,可以覆蓋各種環境:
function cancelHandler(event) {
var event = event || window.event; // 供 IE 使用
if (event.preventDefault) event.preventDefault(); // 標準
if (event.returnValue !== undefined) event.returnValue = false; // 舊 IE
return false; // 供以 DOM 屬性方式註冊的 handler 使用
}
目前的 DOM 規範另外定義了唯讀屬性 defaultPrevented,可以用來「查詢」是否已被取消,這在事件會傳給多個監聽器時很有用。
preventDefault() 的用途是阻止瀏覽器的內建動作,例如:攔住 <a> 的跳轉、阻止 checkbox 被勾選、阻止表單送出、阻止拖曳圖片。
這是差異最大的地方:
return false 只取消預設行為,不會阻止冒泡。return false 相當於同時呼叫 preventDefault() 與 stopPropagation(),兩件事都做了。以下用原生 JS 示範「只取消預設、不阻止冒泡」:
<div id='div' onclick='alert("div");'>
<ul onclick='alert("ul");'>
<li onclick='alert("li");'>
<a href="https://example.com/" id="testB">example.com</a>
</li>
</ul>
</div>
<script>
var a = document.getElementById("testB");
a.onclick = function () {
return false; // 只阻止跳轉,li / ul / div 的 alert 仍會依序跳出
};
</script>
點下去時,瀏覽器不會跳轉,但 alert 仍會依 li → ul → div 的順序發生,這就是「沒有阻止冒泡」的樣子。
標準做法是 stopPropagation();IE9 之前則是設定 cancelBubble = true:
function stopHandler(event) {
event = event || window.event;
if (event.stopPropagation) {
event.stopPropagation();
} else {
event.cancelBubble = true;
}
}
要注意 stopPropagation() 的作用範圍:它阻止事件傳到其他節點,但同一個元素上的其他監聽器仍會被執行。若連這些也要攔下,需要使用 stopImmediatePropagation():
el.addEventListener('click', function (e) {
e.stopImmediatePropagation(); // 同元素的後續監聽器也不執行
}, false);
另外,stopPropagation() 在捕獲階段、目標階段、冒泡階段都能呼叫,效果都是「不再往下傳遞」。
e.preventDefault()e.stopPropagation()return falsee.stopImmediatePropagation()被取消預設的表單不會觸發 submit 事件。如果你在 submit 上 preventDefault() 之後想手動送出,記得用 form.requestSubmit() 而非 form.submit(),後者不會觸發 submit 事件與驗證。
passive 監聽器無法 preventDefault。為了讓捲動更順,touchstart、touchmove、wheel 在部分瀏覽器中被預設為 passive,此時呼叫 preventDefault() 無效並會在 console 出現警告。需要攔時得明確指定:
el.addEventListener('touchmove', handler, { passive: false });
別輕易阻止冒泡。它會讓其他依賴事件冒泡的功能(例如掛在 document 上的分析追蹤、第三方 modal 的關閉邏輯)失效,是debug時很難察覺的問題來源。除非有明確理由,優先考慮在 handler 裡用條件判斷,而不是直接切斷傳遞。