jQuery 把原生的事件物件做了一層標準化包裝,讓你在不同瀏覽器上都能用同一套屬性。但真正讓人卡住的往往不是屬性名稱,而是 event.target 和 event.currentTarget 到底差在哪。本文把常用屬性逐一用可執行的範例跑過,最後整理冒泡與預設行為的控制方式。
$("div").click(function (e) {
console.log(e.type); // click
});
$("div").click(function (e) {
console.log(e.target); // 實際被點到的元素
});
可以是數字、字串、陣列或物件,這在做事件委派時特別好用:
$("div").bind("click", { "name": "zhang", "age": 20 }, function (e) {
for (var i in e.data) {
console.log(i + " = " + e.data[i]);
}
});
滑鼠從哪裡來、要往哪裡去,就靠它:
$("div").mouseover(function (e) {
console.log(e.relatedTarget); // 例如 body,代表滑鼠是從 body 移進來的
});
這一項最容易搞混,用事件委派來看最清楚:
<ul>
<li>item1</li>
<li>item2</li>
<li>item3</li>
</ul>
<script>
// 事件綁在 ul 上,但真正被點的是 li
$("ul").click(function (e) {
console.log(e.target); // li ← 觸發者
console.log(e.currentTarget); // ul ← 綁定者
});
</script>
一句話記法:target 是「誰被點」,currentTarget 是「事件綁在誰身上」。currentTarget 等於回呼裡的 this。
$("div").click(function () { return "123"; });
$("div").click(function (e) {
console.log(e.result); // 123
});
做「避免連續點擊」這類節流判斷時會用到:
$("div").click(function (e) {
console.log(e.timeStamp);
});
$("div").mousedown(function (e) {
var key = '';
switch (e.which) {
case 1: key = "左鍵"; break;
case 2: key = "中鍵"; break;
case 3: key = "右鍵"; break;
}
console.log(key);
});
同一個屬性也能拿鍵盤按鍵碼:
$("input").keyup(function (e) {
console.log(e.which);
});
同類型的還有 altKey、shiftKey:
$("input").keyup(function (e) {
console.log(e.ctrlKey); // 回傳布林值
});
$(document).click(function (e) {
console.log("screenX: " + e.screenX); // 相對整個螢幕
console.log("pageX: " + e.pageX); // 相對文件(含捲動量)
console.log("clientX: " + e.clientX); // 相對視窗左上角
});
三者差別很重要:pageX 含捲動距離,clientX 不含。要計算相對於文件的絕對位置用前者,要定位彈出層這種跟著視窗走的元素用後者。
點擊一個元素時,事件會由內向外逐層往上傳,直到 document。這就是為什麼下面三個按鈕的行為會互相影響:
$("input").click(function () { console.log("按鈕被觸發"); });
$("div").click(function () { console.log("div被觸發"); });
$(document).click(function () { console.log("document被觸發"); });
// 點 input → 三個訊息都印出來
// 點 div → 印出 div 和 document
// 點 document → 只印 document
$("input").click(function (e) {
console.log("按鈕被觸發");
e.stopPropagation();
});
$("div").click(function (e) {
console.log("div被觸發");
e.stopPropagation();
});
$(document).click(function () { console.log("document被觸發"); });
加了 stopPropagation() 之後,不管你怎麼點,都只會觸發自己那一層。
例如攔下連結跳轉:
$("a").click(function (e) {
e.preventDefault();
});
$("a").click(function (e) {
console.log("a");
e.stopPropagation();
e.preventDefault();
});
$("div").click(function () { console.log("div"); });
或者簡寫成一句 return false:
$("a").click(function () {
console.log("a");
return false; // 等同 stopPropagation + preventDefault
});
$("div").click(function () { console.log("div"); });
這個方法比 stopPropagation() 更狠,它連同一元素上的其他事件處理器都不執行:
$("a").click(function (e) {
console.log("a");
// e.preventDefault(); → 三個都觸發
// e.stopPropagation(); → 觸發前兩個
e.stopImmediatePropagation(); // 只觸發第一個
});
$("a").click(function () { console.log("i am a"); });
$(document).click(function () { console.log("i am document"); });
// 是否已取消預設行為
$("a").click(function (e) {
e.preventDefault();
console.log(e.isDefaultPrevented()); // true
});
// 是否已呼叫 stopPropagation()
$("div").click(function (e) {
e.stopPropagation();
console.log(e.isPropagationStopped()); // true
});
// 是否已呼叫 stopImmediatePropagation()
$('div').click(function (e) {
e.stopImmediatePropagation();
console.log(e.isImmediatePropagationStopped()); // true
});
能用委派就不要逐一綁定。$("ul").on("click", "li", handler) 只需要一個監聽器就能處理無限多個動態產生的 li,效能與記憶體都遠優於替每個元素各綁一次。
return false 要慎用。它同時阻擋冒泡與預設行為,副作用比你想像的大。在表單驗證這種場景,如果外層還有需要收到事件的監聽器,return false 會讓對方永遠收不到。這時候應該只呼叫 preventDefault(),把意圖表達清楚。
把 target 與 currentTarget 分清楚,再記住「stopPropagation 管冒泡、preventDefault 管預設行為、return false 兩個都管」,事件處理就很少有搞不定的情況。