DIV CSS 佈局教程網

jQuery 的 on() 綁定與 off() 解除綁定詳解
編輯:JQuery入門技巧     

自 jQuery 1.7 起,on() 成為官方唯一的推薦寫法,bind()、live()、delegate() 在內部都是轉手呼叫它。要解除綁定則用 off()。兩者是一組對應關係,參數規則幾乎鏡像。

on() 語法

$(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 時指向當前元素。

off() 語法

$(selector).off([events] [, selector] [, handler])
$(selector).off(eventsMap [, selector])

參數含義與 on() 完全相同,只是全部變成篩選條件:只有同時符合所有參數的處理函式才會被移除。參數給得越多,範圍越小。

  • 省略 selector:移除為「任何元素」綁定的該事件處理函式。
  • 省略 handler:移除指定元素、指定事件類型上的所有處理函式。
  • 全部省略:$("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();

最容易踩的坑:selector 必須一致

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。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved