JavaScript 之父能定義語言,卻無法命令瀏覽器廠商統一 DOM。於是有了 JScript、ActionScript 等各家分支,也才有了後來的標準化。事件模型正是分裂最嚴重的一塊,本文記錄一套自建跨瀏覽器事件系統的完整思路。
借用瀏覽器內建的 DOM 事件模型,會立刻遇到三個後果:第一,事件必須綁定在某個 DOM 物件上,window、document 或元素節點,無法獨立存在;第二,各家對 DOM 的支持程度不一,模型一致性無從保證;第三,物件與回調之間極易形成循環引用,在舊 IE 上會造成記憶體無法回收。
更麻煩的是,IE 與標準瀏覽器連事件物件本身都不一樣,回調的執行順序也不同——IE 是無序的,標準是按綁定先後。網路上常見的 addEvent 雖可用,卻沒有真正解決這些問題。
於是改用最樸素的 DOM0 方式:把多個回調放進一個陣列,觸發時用 for 迴圈依序執行。
dom.attachEvent = function(el, type, handler) {
if (!el.events) el.events = {};
var handlers = el.events[type];
if (!handlers) {
handlers = el.events[type] = [];
if (el["on" + type]) handlers[0] = el["on" + type];
}
handlers.push(handler);
el["on" + type] = dom.handleEvent;
};
dom.detachEvent = function(el, type, handler) {
if (el.events && el.events[type]) {
el.events[type].remove(handler);
}
};
dom.handleEvent = function (event) {
event = event || fixEvent(((this.ownerDocument || this.document || this).parentWindow || window).event);
var returnValue = true;
var handlers = this.events[event.type];
for (var i = 0, n = handlers.length; i < n; i++) {
if (handlers[i](event) === false) returnValue = false;
}
return returnValue;
};
function fixEvent(event) {
event.preventDefault = fixEvent.preventDefault;
event.stopPropagation = fixEvent.stopPropagation;
return event;
}
fixEvent.preventDefault = function() { this.returnValue = false; };
fixEvent.stopPropagation = function() { this.cancelBubble = true; };
流程可以這樣理解:以一個 dom 物件充當命名空間;為 Array 擴充 indexOf、remove、removeAt;attachEvent 在元素上掛一個 events 雜湊表,按事件類型存放回調陣列;handleEvent 負責取得並修正事件物件,再依序把事件當作第一個參數傳給每個回調;fixEvent 則補上 IE 缺少的標準方法。
第一版還有個漏洞——IE 的事件物件沒有正確的 currentTarget。修法是在派發時顯式補上。
dom.handleEvent = function (event) {
event = event || window.event;
event = dom.fixEvent(event);
event.currentTarget = this; // 修正 currentTarget
var returnValue = true;
var handlers = this.events[event.type];
for (var i = 0, n = handlers.length; i < n; i++) {
if (handlers[i](event) === false) returnValue = false;
}
return returnValue;
};
接下來借鑑 jQuery 的做法,設計一個自己的事件物件。先用兩個小工具建立事件類型對照表,再定義構造函數與原型方法。
dom.oneObject = function(arr, val){
var result = {}, value = val !== undefined ? val : 1;
for (var i = 0, n = arr.length; i < n; i++) result[arr[i]] = value;
return result;
};
dom.mixin = function(result, source) {
if (arguments.length === 1) { source = result; result = dom; }
if (result && source) {
for (var key in source) source.hasOwnProperty(key) && (result[key] = source[key]);
}
if (arguments.length > 2) {
var others = [].slice.call(arguments, 2);
for (var i = 0, n = others.length; i < n; i++) {
result = arguments.callee(result, others[i]);
}
}
return result;
};
var MouseEventOne = dom.oneObject(["click","dblclick","mousedown","mousemove",
"mouseout","mouseover","mouseup"], "[object MouseEvent]");
var HTMLEventOne = dom.oneObject(["abort","blur","change","error","focus",
"load","reset","resize","scroll","select","submit","unload"], "[object Event]");
var KeyboardEventOne = dom.oneObject(["keyup","keydown","keypress"], "[object KeyboardEvent]");
var EventMap = dom.mixin({}, MouseEventOne, HTMLEventOne, KeyboardEventOne);
dom.Event = function(src) {
if (!this.preventDefault) return new dom.Event.prototype.init(src);
};
dom.Event.prototype = {
init: function(src){
if (src && src.type) {
this.originalEvent = src;
this.type = src.type;
} else {
this.type = src;
}
this.timeStamp = new Date().valueOf();
this.expando = true; // 標記為偽事件物件
},
toString: function(){ return EventMap[this.type] || "[object Event]"; },
preventDefault: function() {
this.isDefaultPrevented = returnTrue;
var e = this.originalEvent;
if (!e) return;
if (e.preventDefault) e.preventDefault();
e.returnValue = false;
},
stopPropagation: function() {
this.isPropagationStopped = returnTrue;
var e = this.originalEvent;
if (!e) return;
if (e.stopPropagation) e.stopPropagation();
e.cancelBubble = true;
},
stopImmediatePropagation: function() {
this.isImmediatePropagationStopped = returnTrue;
this.stopPropagation();
},
isDefaultPrevented: returnFalse,
isPropagationStopped: returnFalse,
isImmediatePropagationStopped: returnFalse
};
這個構造函數只實作了 W3C 事件模型的少數方法,其餘屬性靠 fixEvent 以複製方式補齊;並用 expando 標記來區分原生與偽事件物件,避免重複包裝。
var buttonMap = { 1:1, 4:2, 2:3 };
dom.fixEvent = function(event){
if (event.expando) return event;
var originalEvent = event;
event = dom.Event(originalEvent);
for (var prop in originalEvent) {
if (typeof originalEvent[prop] !== "function") event[prop] = originalEvent[prop];
}
if (!event.target) event.target = event.srcElement || document;
if (event.target.nodeType === 3) event.target = event.target.parentNode;
if (!event.relatedTarget && event.fromElement) {
event.relatedTarget = event.fromElement === event.target ? event.toElement : event.fromElement;
}
if (event.pageX == null && event.clientX != null) {
var doc = document.documentElement, body = document.body;
event.pageX = event.clientX + (doc && doc.scrollLeft || body && body.scrollLeft || 0)
- (doc && doc.clientLeft || body && body.clientLeft || 0);
event.pageY = event.clientY + (doc && doc.scrollTop || body && body.scrollTop || 0)
- (doc && doc.clientTop || body && body.clientTop || 0);
}
if (!event.which && ((event.charCode || event.charCode === 0) ? event.charCode : event.keyCode)) {
event.which = event.charCode || event.keyCode;
}
if (!event.metaKey && event.ctrlKey) event.metaKey = event.ctrlKey;
if (!event.which && event.button !== undefined) event.which = buttonMap[event.button];
return event;
};
這段程式幾乎是照 jQuery 的邏輯搬運,原因無他——在所有類庫中,jQuery 的屬性補齊做得最乾淨:target 缺失時退回 srcElement、文字節點上推到父元素、relatedTarget 由 fromElement 換算、pageX/pageY 由 clientX/Y 加上捲動量補出、按鍵順序則靠對照表把 IE 的 1/2/4 轉成標準的 1/2/3。
把龐大的 events 物件直接掛在元素上並不理想,不利於集中管理與記憶體回收;fixEvent 也仍有邊界,某些邊角屬性永遠補不完。真正完整的方案需要引入事件註冊表與延遲回收機制,那是下一階段的課題。
以今天的眼光回看,這套程式碼的價值已不在於實用——現代專案有 addEventListener 與成熟框架可用——而在於它完整示範了「如何抽象出一層跨環境一致介面」的思考過程。