當頁面上有一塊區域是透過 Ajax 更新的,而它周圍存在不會被替換的公共元素時,就要特別小心事件綁定的位置。這是一個很常踩、而且症狀很難定位的問題。
以一個帶公共工具列的列表畫面為例:
| Menu1 | Menu2 -------------------------------------------- ID TITLE DESCRIPTION OPERATION 1 test1 hey test X - ... 2 test2 why not X - ... --------------------------------------------
很多人會把事件綁定寫在 Ajax 的 success 回呼裡:
$.ajax({
// ...
success: function(data) {
$('Menu1').click(function(){
// do something
});
}
});
問題在這裡:Menu1 是公共工具列,它不會隨著列表資料更新而被重新載入。所以每次列表刷新、success 再跑一次,$('Menu1') 上就多綁一個 click 處理函式。更新五次之後,點一下 Menu1 會執行五次同樣的動作。
Ajax 列表更新的結果處理中,不能包含工具列事件偵聽的重新初始化。公共元素的事件該綁一次就綁一次,寫在頁面初始化階段即可。
// 頁面載入時綁一次
$('#Menu1').on('click', function(){ /* ... */ });
// Ajax 只負責更新列表
function loadList() {
$.get('/api/list', function(data){
$('#list').html(data);
bindRowEvents(); // 只有列表內的元素需要重新綁
});
}
這是更根本的解法。把監聽器掛在不會被替換的祖先元素上,透過 event.target 判斷實際來源:
// 綁一次,之後無論列表更新幾次都不必重綁
$('#list').on('click', '.btn-delete', function(e){
e.preventDefault();
var id = $(this).closest('tr').data('id');
// ...
});
事件委派同時解決了「動態產生的元素無法用一般方式綁定」的問題,是處理這類場景的首選。
$('#list').off('click', '.btn-delete').on('click', '.btn-delete', handler);
// 或使用命名空間,只清掉自己綁的
$('.row').off('click.myModule').on('click.myModule', handler);
命名空間(.myModule)是 jQuery 提供的好用功能,能避免誤刪其他模組綁在同元素上的事件。
在 DevTools 的 Elements 面板選中元素,右側的「Event Listeners」會列出該元素上所有已註冊的監聽器與數量。同一個事件出現好幾次,基本就是重複綁定。jQuery 專案也可以用 $._data(el, 'events') 查看。
除了事件重複綁定,Ajax 局部更新還有兩個常見陷阱:一是 setInterval 這類計時器如果寫在回呼裡,也會隨更新次數倍增;二是插入的 HTML 若含有 <script>,jQuery 會主動執行它,非預期的副作用往往從這裡來。用 .html() 時要確認內容來源可信。