曾經遇到這樣的需求:點一下文字欄位,下方展開一個多選清單;欄位失焦時清單要收起來。問題是——當我想點清單裡的核取方塊時,欄位先失焦、清單立刻消失,根本來不及選。查了一整天資料,最後是靠「事件冒泡」才解開的。
先看這段程式碼:
<table>
<tr><td><span>冒泡事件測試</span></td></tr>
</table>
<script type="text/javascript">
$(function () {
$("table").click(function () { alert("table alert"); });
$("td").click(function () { alert("td alert"); });
$("span").click(function () { alert("span alert"); });
});
</script>
點一下 <span>,你會依序看到三個 alert:span → td → table。這就是事件冒泡:同一個事件會從最內層的元素往外一層層觸發。會發生這種事,是因為多個嵌套標籤上綁了同一個事件,而瀏覽器預設會讓事件沿著 DOM 樹往上傳遞。
如果不想讓事件往外傳,在處理函式裡呼叫 e.stopPropagation():
<script type="text/javascript">
$(function () {
$("table").click(function () { alert("table alert"); });
$("td").click(function () { alert("td alert"); });
$("span").click(function (e) {
alert("span alert");
e.stopPropagation(); // 事件到此為止
});
});
</script>
這下點 <span> 只會跳出一個 alert。回到一開始的問題:把 click 監聽綁在 document 上,再對文字欄位與多選清單呼叫 stopPropagation(),點它們時就不會觸發外層的收合邏輯了。
要取得事件相關資訊(鍵值、游標座標、目標元素等),只要在函式加上一個參數 e,它就是事件物件。
$("a").click(function (e) {
alert("默認行為被禁止喽");
e.preventDefault(); // 不跳轉
});
<a href="https://www.baidu.com">測試</a>
| 方法 | 作用 |
|---|---|
| e.preventDefault() | 阻止瀏覽器對這個元素的預設行為(連結跳轉、表單送出、核取方塊被勾上…) |
| e.stopPropagation() | 阻止事件往父元素傳遞 |
| return false | 在 jQuery 處理器中等於同時執行上面兩者 |
翻開 jQuery 原始碼,可以看到就是這段:
if (ret === false) {
event.preventDefault();
event.stopPropagation();
}
所以如果你只想阻止冒泡、但保留連結跳轉,就不能寫 return false,必須明確呼叫 e.stopPropagation()。反之亦然。
除了 stopPropagation(),還有 e.stopImmediatePropagation()。差別在於:當同一個元素上綁了多個同類型處理器時,stopPropagation() 不會阻止它們執行,而 stopImmediatePropagation() 會連後續的處理器一起擋掉。
$('#btn').on('click', function(e){ e.stopImmediatePropagation(); });
$('#btn').on('click', function(e){ /* 這段不會執行 */ });
除了阻止冒泡,還有一個更根本的解法:改用 mousedown 判斷點擊位置是否在清單外部,或用 focusout 搭配 relatedTarget 檢查焦點移到哪裡去。實際寫法如下:
$('#txt').on('focus', function(){ $('#list').show(); });
$(document).on('click', function(e){
// 點擊對象既不是輸入框,也不在清單內,才收起
if (!$(e.target).closest('#txt, #list').length) {
$('#list').hide();
}
});
用 closest() 判斷「點到的元素是否在自己或自己的祖先裡」,比到處散落的 stopPropagation() 更容易維護,也不容易忘記補上而產生零星的 bug。