on() 在 jQuery 1.7 加入,之後成為事件綁定的唯一正解——它把原本 bind()、delegate()、live() 三套寫法收攏成一支函式。要真正用好它,關鍵是理解「直接事件」與「委派事件」的區別。
實際應用可參考這個例子,延伸閱讀:on() 用法、事件與命名空間、效能建議。
.on( events [, selector ] [, data ], handler(eventObject) )
.on( events [, selector ] [, data ] ) // events 傳入物件
"click"、"keydown.myPlugin"、".myPlugin"。傳入物件時,鍵是事件、值是處理函式。event.data。false,等同 return false。任何事件名稱都能作為 events 參數,包含標準瀏覽器事件與以 .trigger() 觸發的自訂事件。名稱後面可以加上命名空間來分類,例如 "click.myPlugin.simple" 同時屬於 myPlugin 與 simple 兩個命名空間。之後用 .off("click.myPlugin") 就能只解除這一批,不影響同一元素上的其他 click 處理程序。命名空間與 CSS 的 class 類似,不分層級、只要名稱相符即可;以下底線開頭的命名空間保留給 jQuery 使用。
多數瀏覽器事件會冒泡,從最深處的目標元素一路往 body 與 document 傳遞(IE8 及以下對 change、submit 等事件的冒泡由 jQuery 模擬補齊)。依此可分出兩種類型:
this 指向符合 selector 的那個元素,可能並不等於 event.target。直接事件有個前提:元素必須在呼叫 .on() 的當下已經存在於文件中,所以最好在 ready 事件中綁定。委派事件則沒有這個限制——只要祖先元素還在,日後新增的後代也能被處理。這正是委派最大的優勢。
另一個優勢是效能。若表格有 1000 列,逐一綁定的寫法:
$("#dataTable tbody tr").on("click", function(event){
alert($(this).text());
});
委派寫法則只在 tbody 上放一個處理程序,事件最多冒泡一層:
$("#dataTable tbody").on("click", "tr", function(event){
alert($(this).text());
});
需注意:委派事件不適用於 SVG 元素。
jQuery 會把一個事件物件傳給處理程序。它是瀏覽器原生事件的正規化子集,需要未經修改的原始物件時,可從 event.originalEvent 取得。event.type 是事件名稱,event.target 是最深處的觸發元素。
控制事件走向的常用方法:
event.stopPropagation():阻止事件繼續冒泡,但同元素上的其他處理程序仍會執行。event.stopImmediatePropagation():連同元素上尚未執行的處理程序一起阻止(處理程序的執行順序等同綁定順序)。event.preventDefault():取消瀏覽器的預設行為,例如連結的跳轉、表單的送出。return false:等同同時呼叫上面前兩者。也可直接把 false 當作 handler,例如 $("a.disabled").on("click", false);。處理程序中的 this 指向正在處理事件的元素:直接事件下是被綁定的元素,委派事件下是符合 selector 的元素。要用 jQuery 方法時,記得包成 $(this)。
若 data 不是 null 或 undefined,每次觸發時都會出現在 event.data 上。建議傳入物件以便一次帶多個值;若 data 是字串,務必明確帶上 selector 或傳 null,以免被誤認為選擇器。同一個處理函式可以帶不同資料綁定多次:
function greet(event) {
alert("Hello " + event.data.name);
}
$("button").on("click", { name: "Karl" }, greet);
$("button").on("click", { name: "Addy" }, greet);
click 這類事件頻率低,效能通常不成問題;但 mousemove、scroll 每秒可能觸發數十次,就該認真對待。三個方向:減少處理程序中的工作量、把要用的資訊事先快取而非重算、必要時用 setTimeout 節流畫面更新。
委派事件的綁定位置也很有講究。事件每次發生時,jQuery 得從目標元素沿路比對到綁定處,綁得越靠近 document 就越費力。請避免在大型文件中把大量委派事件掛在 document 或 body 上。此外,tag#id.class 形式的簡單選擇器(如 "#myForm"、"a.external"、"button")過濾速度很快,含層級的複雜選擇器則明顯較慢。比較兩個寫法:
// 建議
$("#commentForm").on("click", ".addNew", addComment);
// 避免
$("body").on("click", "#commentForm .addNew", addComment);
click() 這類速記方法仍可用於綁定或觸發事件。"hover" 可作為 "mouseenter mouseleave" 的縮寫,但與接受兩個函式的 .hover() 方法不同;使用時應檢查 event.type 分辨進入或離開。object、embed、applet 元素無法附加資料,因此不支援 jQuery 事件綁定。focusin 與 focusout;綁定委派事件時建議直接使用這組名稱。window.onerror。// 點擊段落時顯示其文字
$("p").on("click", function(){
alert($(this).text());
});
// 以物件一次綁定多個事件
$("div.test").on({
click: function(){ $(this).toggleClass("active"); },
mouseenter: function(){ $(this).addClass("inside"); },
mouseleave: function(){ $(this).removeClass("inside"); }
});
// 委派:為日後新增的段落也生效
var count = 0;
$("body").on("click", "p", function(){
$(this).after("<p>Another paragraph! " + (++count) + "</p>");
});
// 只取消預設行為,仍允許事件冒泡
$("form").on("submit", function(event) {
event.preventDefault();
});
// 自訂事件
$("p").on("myCustomEvent", function(e, myName, myValue){
$(this).text(myName + ", hi there!");
});
$("button").click(function () {
$("p").trigger("myCustomEvent", [ "John" ]);
});
把 on() 讀通,等於同時掌握了事件綁定、委派、資料傳遞與效能調校。它不只是 bind() 的替代品,而是 jQuery 事件模型的核心。