jQuery 綁定事件的方式有好幾種,其中一個最容易踩的坑是:對動態產生的元素直接用 on 或 bind 綁事件,結果一點都沒反應。本文把這個問題講清楚,並整理基本寫法。
$(this).bind({
click: function () {
window.open(alert('OK'));
},
mouseover: function () {
window.open(alert('OK'));
},
mouseout: function () {
window.open(alert('OK'));
}
});
傳入物件字面值,key 是事件名稱、value 是處理函式,可以一次掛上多個事件,比連續呼叫 .click()、.mouseover() 更簡潔。
用 jQuery 的 on 綁定動態生成的元素時,不能直接選那個元素本身,而要選它「非動態生成」的父節點,再用事件委派(event delegation)往下找:
// 錯誤:元素是 ajax 回來才產生的,這行執行時它還不存在
$('.dynamic-btn').on('click', handler);
// 正確:綁在確定存在的父層,由它攔下冒泡上來的事件
$(document).on('click', '.dynamic-btn', handler);
// 或更精準一點
$('#list-container').on('click', '.dynamic-btn', handler);
原理是事件冒泡:點擊發生在子元素,但事件會一路往上冒到父層。只要父層的監聽器存在,就能攔下任何時間點新增的子元素事件,並用第二個參數(selector)判斷來源。
這也是為什麼看 jQuery 原始碼會發現 on 內部就是靠 closest 做 selector 比對——理解這一層,就不會再被「明明寫的一樣卻沒作用」困住。
bind():直接綁在選到的元素上,不支援動態元素。jQuery 1.7 起 deprecated。live():曾經用來處理動態元素,但實作方式是綁到 document 上再全域比對 selector,效能不佳。已於 1.9 移除。delegate():可指定委派根節點,比 live 好得多。on():jQuery 1.7 引入的統一介面,bind、delegate、live 的功能全部由它涵蓋,是目前唯一推薦的寫法。// 綁定命名空間,方便日後整批移除
$('.btn').on('click.myApp', handler);
// 只移除該命名空間
$('.btn').off('click.myApp');
// 移除全部 click
$('.btn').off('click');
另一個常見問題是「點一次就觸發多次」。原因幾乎都是同一個處理函式被重複綁上——例如元件初始化被呼叫兩次。除錯時可以先用 $._data(el, 'events') 檢視綁了幾個監聽器,或在綁定前先 off 一次。
順帶一提,範例中的 window.open(alert('OK')) 寫法有問題:alert 會先執行並回傳 undefined,等於呼叫 window.open(undefined)。這應該只是示意用的佔位程式碼,實戰時別照抄。