DIV CSS 佈局教程網

JavaScript 事件處理機制實作:為 DOM 元素加上多事件與自訂事件
編輯:關於JavaScript     

日常的 onclick = function(){} 寫法有個致命限制:同一個元素同一個事件只能掛一個處理函式,後掛的會把前面的直接覆蓋掉。一旦要替元素綁多個監聽、要能逐一移除、或是封裝自控制元件時想自訂事件,這種寫法立刻不敷使用。

瀏覽器其實提供了 addEventListener 與 attachEvent 兩套原生 API,把它們包一層,就能模擬出近似 C# 委派(delegate)的事件觸發機制。

整體架構

程式碼分成三個部分:JEvents 提供事件註冊、移除與觸發的核心;JEventsExtendMethod 以靜態方法的形式處理具體 DOM 元素;JEventWrap 則把各家瀏覽器的事件物件包裝成一致的介面。

核心:addListener 與 fireEvent

註冊時重點有三:正規化事件名(把 onclick 與 click 視為同一件事)、用 createDelegate 預先綁好 this 與自訂參數、以及給每個處理函式配一個 uid 當作識別標籤,日後移除時才找得到它。

this.addListener = function(eventName, fn, scope /*, Args... */){
  if (typeof(eventName) != "string" || eventName.length == 0) return;
  if (typeof(fn) != "function") return;

  eventName = eventName.toString().toLowerCase();
  var enFX = eventName.indexOf("on") == 0 ? eventName.substr(2) : eventName;
  if (!this.events[enFX]) throw "Error! Event '" + enFX + "' doesnt exist.";

  var sp = scope || window;
  var callArgs = Array.prototype.slice.call(arguments, 3);
  var delegate = fn.createDelegate(callArgs, sp);

  if (!fn.uid){                       // 為方法配發唯一標籤
    var time = new Date();
    fn.uid = "" + time.getMinutes() + time.getSeconds() + time.getMilliseconds();
  }
  delegate.uid = getCacheAttName(enFX, fn.uid);
  if (typeof(this.events[enFX]) != "object") this.events[enFX] = [];
  this.events[enFX].push(delegate);
};

this.fireEvent = function(eName, eventArg){
  eName = eName.toString().toLowerCase();
  var enFX = eName.indexOf("on") == 0 ? eName.substr(2) : eName;
  var Arg = [];
  if (typeof(eventArg) != "undefined"){
    if (Object.prototype.toString.call(eventArg) === "[object Array]") Arg = eventArg;
    else Arg.push(eventArg);
  }
  if (typeof(this.events[enFX]) == "object"){
    var functions = this.events[enFX];
    for (var i = 0; i < functions.length; i++){
      functions[i].apply(window, Arg);      // 逐一觸發,任一處理函式拋錯不影響其他
    }
  }
};

跨瀏覽器綁定

標準瀏覽器走 addEventListener,事件依註冊順序(隊列)執行;舊版 IE 走 attachEvent,事件名要補上 on 前綴,而且執行順序是堆疊(後註冊的先跑)。這個順序差異在依賴執行次序的場景中是隱形的坑。

bind: function(el, eventName, fn, scope /*, Args... */){
  if (typeof(el) == "undefined" || el == null) return;
  var indexOfon = eventName.toString().toLowerCase().indexOf("on");
  var enIE = indexOfon == 0 ? eventName : "on" + eventName;
  var enFX = indexOfon == 0 ? eventName.substr(2) : eventName;

  var callArgs = Array.prototype.slice.call(arguments, 4);
  var delegate = fn.createDelegate(callArgs, scope || window);

  if (el.addEventListener){
    el.addEventListener(enFX, delegate, false);
  } else if (el.attachEvent){
    el.attachEvent(enIE, delegate);
  }

  if (!fn.uid){
    var time = new Date();
    fn.uid = "" + time.getMinutes() + time.getSeconds() + time.getMilliseconds();
  }
  if (!el.id) el.id = JCore.id(el, null);

  // 把 delegate 存進快取,unbind 時才拿得回同一個函式參照
  this.cache.setCache(el.id, this.getCacheAttName(enFX, fn.uid), delegate);
}

這裡有個關鍵設計:移除監聽時必須傳入同一個函式參照,但 createDelegate 每次呼叫都會產生新的函式。因此程式另外維護一份 cache,以「元素 id + 事件名 + 函式 uid」組成的鍵(如 handle-click-1712)存放 delegate,unbind 時再取出來比對移除。

事件物件的統一包裝

IE 用 event.srcElement,標準瀏覽器用 event.target;IE 的 offsetX/offsetY 是相對事件源,非 IE 則需自行以 clientX - target.offsetLeft 推算。JEventWrap 把這些差異收攏成同一組屬性,讓呼叫端不必到處寫 e = e || window.event。

if (event.srcElement){                       // IE
  this.srcElement = event.srcElement;
  this.offsetX = event.offsetX;
  this.offsetY = event.offsetY;
} else {                                     // 標準瀏覽器
  this.srcElement = event.target;
  this.offsetX = event.clientX - event.target.offsetLeft;
  this.offsetY = event.clientY - event.target.offsetTop;
}

今天怎麼寫

這套實作的價值在於把「事件系統該長什麼樣子」講清楚,理解之後你會發現它就是現代框架事件系統的雛形。不過在今天的專案中,addEventListener 已全面可用,多監聽、逐一移除、事件 delegation 都能直接用原生 API 完成;自訂事件則可用 CustomEvent 搭配 dispatchEvent,不必再手刻 uid 與快取表。此外範例用「目前時間字串」產生 uid,在高頻註冊時有碰撞風險,實戰應改用自增計數或 crypto.randomUUID()。

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