事件是 jQuery 用得最多的部分,也是細節最容易出錯的地方。以下從最基本的綁定談到事件委托與觸發機制。
直接用方法名:
$('li').click(function (event) { });
或用 bind 串接:
$('li')
.bind('click', function (event) { })
.bind('click', function (event) { });
bind 的優勢是能一次綁多個事件、也方便後續統一解除。
為什麼需要它?假設已經給 li 綁了兩個 click:
$('li')
.bind('click', function (event) { })
.bind('click', function (event) { });
現在只想解除其中一個,若寫 $('li').unbind('click'),兩個都會被移除。命名空間就是為了解這個問題——它讓你能精準地解除自己綁的那一個。
使用方式是「事件名稱.命名空間名稱」:
$('li')
.bind('click.editMode', function (event) { })
.bind('click.displayMode', function (event) { });
$('li').unbind('click.editMode'); // 只解除 editMode 那一個
這個技巧在用插件時特別有用:自己的清理邏輯不會誤傷同一元素上別人綁的事件。
blur、change、click、dblclick、error、focus、focusin、focusout、keydown、keypress、keyup、load、mousedown、mouseenter、mouseleave、mousemove、mouseout、mouseover、mouseup、ready、resize、scroll、select、submit、unload。
$("p").one("click", function () {
$(this).animate({ fontSize: "+=6px" });
});
$("p").click(function () { $(this).slideToggle(); });
$("button").click(function () {
$("p").unbind(); // 移除所有事件
});
Event 是 jQuery 的全域屬性(jQuery.Event)。每次觸發事件時,一個 Event 物件實例會被傳給處理函式。也可以手動建立並觸發:
var e = jQuery.Event("click");
jQuery("body").trigger(e);
// 甚至能夾帶匿名物件
var e2 = jQuery.Event("keydown", { keyCode: 64 });
jQuery("body").trigger(e2);
取值時用 event.keyCode 即可。匿名物件也能透過 bind 的第二個參數傳入:
$("p").click({ param1: "Hello", param2: "World" }, someFunction);
function someFunction(event) {
alert(event.data.param1);
alert(event.data.param2);
}
常用屬性還包括 event.target(觸發來源元素,例如 event.target.nodeName)、currentTarget(冒泡階段的當前元素)、pageX/pageY(相對頁面的座標)、screenX/screenY(相對螢幕)、relatedTarget(滑鼠離開或進入的元素)、which(按鍵或滑鼠鍵)、type、timeStamp、result,以及 altKey、ctrlKey、shiftKey、metaKey 這組修飾鍵旗標。
event.preventDefault() 阻止預設行為;event.stopPropagation() 停止冒泡;event.stopImmediatePropagation() 連同層的其他處理器一起停掉;另有 isDefaultPrevented()、isPropagationStopped()、isImmediatePropagationStopped() 供查詢狀態。
早期用 live() 為「還不存在的元素」建立事件,它能對所有符合選擇器的元素生效,包括之後動態加入的。從 jQuery 1.7 起改用 on():
$("p").on("click", function () { alert("hello"); });
$("button").click(function () { $("p").off("click"); });
$("#foo").on("click", function () { alert($(this).text()); });
$("#foo").trigger("click");
也能在綁定時宣告形參、觸發時傳入實參:
$("#foo").on("custom", function (event, param1, param2) {
alert(param1 + "\n" + param2);
});
$("#foo").trigger("custom", ["Custom", "Event"]);
觸發 jQuery.Event 實例或匿名物件也都可以:
var event = jQuery.Event("logged");
event.user = "foo";
event.pass = "bar";
$("body").trigger(event);
$("body").trigger({ type: "logged", user: "foo", pass: "bar" });
它不會執行元素的預設行為,也不會冒泡。以 focus 為例:
$("input").focus(function () {
$("<span>Focused</span>").appendTo("#id").fadeOut(1000);
});
$("#id").click(function () {
$("input").triggerHandler("focus"); // 只觸發綁定的處理器,不會真的聚焦
});
$("#id").click(function () {
$("input").trigger("focus"); // 處理器與預設行為都會發生
});
有這麼一段結構:
<!DOCTYPE html> <html xmlns="https://www.w3.org/1999/xhtml"> <body> <div> <p><a href="#foo"><span>I am a Link!</span></a></p> <p><a href="#bar"><b><i>I am another Link!</i></b></a></p> </div> </body> </html>
給所有元素(含 document 與 window)綁上 click:
$(function () {
$('*').add([document, window]).on('click', function (event) {
event.preventDefault();
console.log(this);
});
});
點任何元素,事件都會從該元素開始,一層一層往上傳到 window——這就是冒泡。
如何阻止?通常我們只希望在特定元素上發生特定行為,這時針對該元素綁定即可:
$(function () {
$('a').on('click', function (event) {
event.preventDefault();
console.log($(this).attr('href'));
});
});
或在需要時呼叫 event.stopPropagation()。
如何利用?這正是事件委托的基礎。以下有一組清單:
<html>
<body>
<div id="container">
<ul id="list">
<li><a href="https://domain1.com">Item #1</a></li>
<li><a href="/local/path/1">Item #2</a></li>
<li><a href="/local/path/2">Item #3</a></li>
<li><a href="https://domain4.com">Item #4</a></li>
</ul>
</div>
</body>
</html>
直觀的綁法:
$("#list a").on("click", function (event) {
event.preventDefault();
console.log($(this).text());
});
但如果是動態追加的項目:
$("#list").append("<li><a href='https://newdomain.com'>Item #5</a></li>");
點這個新項目什麼都不會發生——因為綁定當下它還不存在。
解法是把事件綁到父層,並在 on() 的第二個參數指定真正的目標:
$("#list").on("click", "a", function (event) {
event.preventDefault();
console.log($(this).text());
});
流程是:點擊某個 a → 事件冒泡到父層 ul → 觸發 ul 上的 click 處理器 → jQuery 判斷冒泡路徑上有符合 "a" 的元素,於是執行回呼,且 this 指向那個 a。
這就是事件委托的價值:把事件綁在父層,等於一次為所有子元素(不論靜態存在或動態新增)都設定了行為。除了省記憶體,在列表 frequently 增刪的場景裡,它是唯一正確的做法。
舊版的 .toggle(fn1, fn2, ...) 能依點擊次數輪流執行多個函式,跑完一圈再回到第一個。這個用法已從 jQuery 1.9 起移除,現在 .toggle() 只剩切換可見性的功能。若需要「點擊輪流切換模式」,請自行用計數器實作。
$(element).mouseenter(function () { }).mouseleave(function () { });
$("p").hover(function () {
$("p").css("background-color", "yellow");
}, function () {
$("p").css("background-color", "pink");
});
要特別注意 mouseenter/mouseleave 與 mouseover/mouseout 的差別:前者在滑鼠進入或離開子元素時不會重複觸發,後者會。做懸停效果時若發現閃爍,通常就是把這兩組用錯了。
用 on() 取代 bind/live/delegate。bind、live、delegate 都已廢棄,$(document).on('click', selector, handler) 一個方法就能涵蓋所有情境,不必再判斷該用哪一個。
委托的選擇器別寫得太寬。把事件綁在 document 上、selector 又寫成 '*' 或通用 class,每次點擊 jQuery 都要比對整條冒泡路徑,效能會明顯下降。綁在最近的、穩定的共同祖先上是最佳平衡點。