delegate() 方法為指定元素(屬於被選元素的後代)添加一個或多個事件處理程序,並規定當這些事件發生時運行的函數。它最大的價值是:綁定的事件對當前元素和未來新增的元素都生效——比如由腳本動態創建的新元素,不必重新綁定。
$(selector).delegate(childSelector, event, data, function)
自 jQuery 1.4.2 起支持以下幾種簽名:
$(selector).delegate(childSelector, event, fn)
$(selector).delegate(childSelector, event, data, fn)
自 1.4.3 起還支持對象映射形式,一次綁定多個事件:
$(selector).delegate(childSelector, eventsMap)
// eventsMap 形如 { mouseover: fn1, mouseout: fn2 }
其中 selector 用於過濾觸發事件的元素,事件必須合法。
<div style="background-color:red">
<p>這是一個段落。</p>
<button>請點擊這裡</button>
</div>
$("div").delegate("button", "click", function() {
$("p").slideToggle();
});
delegate() 可以把事件精確綁定到特定的 DOM 元素上,而不像 live() 那樣掛在 document 上全局代理。以下兩段代碼效果等價:
$("table").delegate("td", "hover", function() {
$(this).toggleClass("hover");
});
$("table").each(function() {
$("td", this).live("hover", function() {
$(this).toggleClass("hover");
});
});
事件在 DOM 中會冒泡。與其給每個子元素單獨綁定監聽器,不如把監聽器掛在共同的祖先上,然後靠 childSelector 判斷事件到底源自哪個後代。這樣做有兩個直接收益:
live() 那種全局代理的開銷。live() 已在 jQuery 1.9 中移除,delegate() 也在 1.7 之後被標記為已棄用。新項目請直接使用 on(),它是統一的事件 API:
$("table").on("hover", "td", function() {
$(this).toggleClass("hover");
});
注意 on() 的參數順序是「事件 → 委派選擇器 → 回調」,與 delegate() 的「子選擇器 → 事件 → 回調」正好相反,遷移時容易寫錯。