日常的 onclick = function(){} 寫法有個致命限制:同一個元素同一個事件只能掛一個處理函式,後掛的會把前面的直接覆蓋掉。一旦要替元素綁多個監聽、要能逐一移除、或是封裝自控制元件時想自訂事件,這種寫法立刻不敷使用。
瀏覽器其實提供了 addEventListener 與 attachEvent 兩套原生 API,把它們包一層,就能模擬出近似 C# 委派(delegate)的事件觸發機制。
程式碼分成三個部分:JEvents 提供事件註冊、移除與觸發的核心;JEventsExtendMethod 以靜態方法的形式處理具體 DOM 元素;JEventWrap 則把各家瀏覽器的事件物件包裝成一致的介面。
註冊時重點有三:正規化事件名(把 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()。