自 jQuery 1.7 起,on() 成為官方唯一的推薦寫法,bind()、live()、delegate() 在內部都是轉手呼叫它。要解除綁定則用 off()。兩者是一組對應關係,參數規則幾乎鏡像。
$(selector).on(events [, selector] [, data ], handler) $(selector).on(eventsMap [, selector] [, data ])
events(String):一個或多個以空格分隔的事件類型,可帶命名空間,例如 "click"、"focus click"、"keydown.myPlugin"。
eventsMap(Object):物件形式的寫法,每個屬性代表事件類型(可含命名空間),屬性值就是處理函式。這種寫法可以為不同事件指定不同函式,比空格分隔靈活。
selector(String,可選):一個 jQuery 選擇器,用來指定「哪些後代元素」可以觸發這個綁定。省略或傳 null 時,表示直接綁在當前元素上;傳了值就是事件委托。
data(任意型別,可選):觸發事件時要透過 event.data 傳給處理函式的資料。
handler(Function):處理函式,會收到一個 jQuery 包裝過的 Event 物件。函式內的 this 指向真正觸發事件的元素——若用了 selector,指向符合選擇器的後代元素;沒用 selector 時指向當前元素。
$(selector).off([events] [, selector] [, handler]) $(selector).off(eventsMap [, selector])
參數含義與 on() 完全相同,只是全部變成篩選條件:只有同時符合所有參數的處理函式才會被移除。參數給得越多,範圍越小。
$("body").off() — 移除該元素上任何事件、任何元素的處理函式(慎用,會把外掛綁的都清掉)。<input id="btn1" type="button" value="點擊1" /> <input id="btn2" type="button" value="點擊2" /> <a id="a1" href="#">CodePlayer</a>
function btnClick1() { alert(this.value + "-1"); }
function btnClick2() { alert(this.value + "-2"); }
var $body = $("body");
// 用事件委托為兩個按鈕分別綁定
$body.on("click", "#btn1", btnClick1);
$body.on("click", "#btn2", btnClick2);
// 為所有 a 元素綁定三個事件
$body.on("click mouseover mouseleave", "a", function (event) {
if (event.type === "click") {
$body.off("click", "#btn1"); // 解除 btn1 的綁定
alert("點擊事件");
} else if (event.type === "mouseover") {
$(this).css("color", "red");
} else {
$(this).css("color", "blue");
}
});
// 移除 btn2 的處理函式
$body.off("click", "#btn2", btnClick2);
// 移除所有 button 的 click 處理函式
// $body.off("click", ":button");
// 移除 body 上所有元素的 click 處理函式
// $body.off("click");
// 移除 body 上所有事件的所有處理函式
// $body.off();
off() 的 selector 參數必須與 on() 時傳入的字串完全相同,否則移除不掉。例如:
$body.on("click", "#btn1", fn);
$body.off("click", ":button"); // ✗ 無效!選擇器不同
$body.off("click", "#btn1"); // ✓ 正確
這點很多人栽過。原因是 jQuery 內部把「事件類型 + 命名空間 + selector」當成識別鍵,selector 字串不同就視為不同的綁定。實務建議:自製元件時統一用命名空間標記,例如 on("click.mywidget", sel, fn) 搭配 off(".mywidget"),就不必記得原本的 selector 寫法。
$("a").on("click.myapp", fn1);
$("a").on("mouseover.myapp", fn2);
$("a").off(".myapp"); // 一次移除自己掛的所有事件,外掛的不受影響
這在寫外掛時幾乎是標配——外掛銷毀時能乾淨地把自己的監聽器全部帶走,不會誤傷同一元素上其他程式碼綁的事件。
事件委托的原理。on(events, selector, handler) 並不是逐一為後代元素綁定,而是把監聽器掛在當前元素上,靠 DOM 事件冒泡攔截。事件冒泡到當前元素時,jQuery 判斷是哪個後代觸發的、是否符合 selector,符合才執行。這也是它能處理「未來才加入的元素」的原因。
回傳 false 的效果。處理函式回傳 false 等同同時呼叫 preventDefault() 與 stopPropagation()。若只為了回傳 false,可以直接把 handler 寫成 false。
只執行一次。需要「觸發後自動移除自己」時用 one(),不必手動在回呼裡 off。