萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 事件綁定統一封裝:兼容 IE attachEvent 與 W3C addEventListener、防止內存洩漏、解決執行順序倒序問題

歷史背景

  • IE ≤ 8:`element.attachEvent('onclick', handler)`
  • W3C 標準:`element.addEventListener('click', handler, false)`
  • 差異:`this` 指向、事件對象、執行順序(IE 倒序)、內存洩漏風險

統一封裝實現(支援多事件、去重、有序執行)


const EventUtil = {
  // 事件 ID 生成器(用於去重)
  _uid: 1,
  _handlers: new WeakMap(), // 元素 -> {type: [{id, fn, wrapper}]}
  
  add(element, type, fn) {
    if (!element || typeof fn !== 'function') return;
    
    // 獲取或創建元素的處理器存儲
    let elemData = this._handlers.get(element);
    if (!elemData) { elemData = {}; this._handlers.set(element, elemData); }
    let typeHandlers = elemData[type];
    if (!typeHandlers) { typeHandlers = []; elemData[type] = typeHandlers; }
    
    // 去重:同一元素、同一類型、同一函數引用不重複添加
    if (typeHandlers.some(h => h.fn === fn)) return;
    
    const id = this._uid++;
    let wrapper;
    
    if (element.addEventListener) {
      // W3C 標準
      wrapper = function(event) {
        // 修正 event 物件
        event = event || window.event;
        event.target = event.target || event.srcElement;
        event.preventDefault = event.preventDefault || function() { this.returnValue = false; };
        event.stopPropagation = event.stopPropagation || function() { this.cancelBubble = true; };
        // 統一 this 指向元素
        return fn.call(element, event);
      };
      element.addEventListener(type, wrapper, false);
    } else if (element.attachEvent) {
      // IE 兼容
      wrapper = function(event) {
        event = event || window.event;
        event.target = event.target || event.srcElement;
        event.preventDefault = function() { this.returnValue = false; };
        event.stopPropagation = function() { this.cancelBubble = true; };
        return fn.call(element, event);
      };
      element.attachEvent('on' + type, wrapper);
    } else {
      // DOM 0 級降級
      element['on' + type] = wrapper;
    }
    
    typeHandlers.push({id, fn, wrapper});
  },
  
  remove(element, type, fn) {
    if (!element) return;
    const elemData = this._handlers.get(element);
    if (!elemData) return;
    const typeHandlers = elemData[type];
    if (!typeHandlers) return;
    
    const idx = typeHandlers.findIndex(h => h.fn === fn);
    if (idx === -1) return;
    
    const {wrapper} = typeHandlers[idx];
    if (element.removeEventListener) {
      element.removeEventListener(type, wrapper, false);
    } else if (element.detachEvent) {
      element.detachEvent('on' + type, wrapper);
    } else {
      element['on' + type] = null;
    }
    
    typeHandlers.splice(idx, 1);
    if (typeHandlers.length === 0) delete elemData[type];
  },
  
  // 移除元素所有事件(防止內存洩漏)
  purge(element) {
    if (!element) return;
    const elemData = this._handlers.get(element);
    if (!elemData) return;
    for (const type in elemData) {
      elemData[type].forEach(({wrapper}) => {
        if (element.removeEventListener) element.removeEventListener(type, wrapper, false);
        else if (element.detachEvent) element.detachEvent('on' + type, wrapper);
        else element['on' + type] = null;
      });
    }
    this._handlers.delete(element);
  }
};

// 使用
EventUtil.add(btn, 'click', handler);
EventUtil.remove(btn, 'click', handler);
EventUtil.purge(container); // 移除容器及所有後代事件(配合 MutationObserver 自動清理)

關鍵問題解決

問題解決方案
IE `this` 指向 window`fn.call(element, event)` 強制綁定
IE 事件對象缺標準屬性Wrapper 內補全 `target`、`preventDefault`、`stopPropagation`
IE 同類事件倒序執行用陣列存儲處理器,按添加順序迴圈調用(而非依賴瀏覽器)
重複綁定同一函數WeakMap + 陣列去重(比較函數引用)
內存洩漏(循環引用)WeakMap 不阻礙 GC、`purge()` 手動清理、頁面卸載時遍歷清理
動態添加元素事件綁定事件委派:`parent.addEventListener(type, e => { if(e.target.matches(selector)) handler(e); })`

現代最佳實踐:原生 addEventListener + 選項物件


element.addEventListener('click', handler, {
  capture: false,    // 冒泡階段
  once: false,       // 不自動移除
  passive: false,    // 不預設 preventDefault(scroll/touch 建議 true)
  signal: abortSignal // AbortController 統一取消
});

// 批次移除
const controller = new AbortController();
elements.forEach(el => el.addEventListener('click', handler, {signal: controller.signal}));
controller.abort(); // 一次性移除所有

事件委派模式(高效能、動態元素自動生效)


function delegate(parent, selector, type, handler) {
  parent.addEventListener(type, e => {
    const target = e.target.closest(selector);
    if (target && parent.contains(target)) {
      handler.call(target, e);
    }
  });
}

// 使用
delegate(document.getElementById('list'), 'li', 'click', function(e) {
  console.log('點擊:', this.dataset.id);
});

總結

雖然現代瀏覽器已全面支援 `addEventListener`,但理解歷史兼容層封裝原理,有助於維護舊專案、設計健壯的事件系統。核心要點:統一 `this`、修正事件對象、保證執行順序、去重、防洩漏、支援委派。新專案請直接使用原生 API 配合 `AbortController`、`{once:true}`、`{passive:true}` 等現代特性,代碼更簡潔、效能更優。

copyright © 萬盛學電腦網 all rights reserved