DIV CSS 佈局教程網

Ajax 局部更新造成 JS 事件重複綁定的陷阱
編輯:關於JavaScript     

當頁面上有一塊區域是透過 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 列表更新的結果處理中,不能包含工具列事件偵聽的重新初始化。公共元素的事件該綁一次就綁一次,寫在頁面初始化階段即可。

三種解法

1. 把公共元素的事件移出回呼

// 頁面載入時綁一次
$('#Menu1').on('click', function(){ /* ... */ });

// Ajax 只負責更新列表
function loadList() {
  $.get('/api/list', function(data){
    $('#list').html(data);
    bindRowEvents();     // 只有列表內的元素需要重新綁
  });
}

2. 改用事件委派

這是更根本的解法。把監聽器掛在不會被替換的祖先元素上,透過 event.target 判斷實際來源:

// 綁一次,之後無論列表更新幾次都不必重綁
$('#list').on('click', '.btn-delete', function(e){
  e.preventDefault();
  var id = $(this).closest('tr').data('id');
  // ...
});

事件委派同時解決了「動態產生的元素無法用一般方式綁定」的問題,是處理這類場景的首選。

3. 若真的需要重綁,先解除

$('#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() 時要確認內容來源可信。

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