DOM 事件看似簡單,實則是跨瀏覽器開發裡差異最密集的一塊。本文依據 W3C DOM 2 Events 標準,系統性整理各瀏覽器在事件綁定、事件物件取得與屬性方法支援上的分歧,並給出實用的相容方案。
依 DOM 2 Events 規範,EventTarget 介面由所有支援 DOM 事件模型的節點(Node)實作,提供 addEventListener 與 removeEventListener 兩個方法,用來綁定或解除事件監聽器。
規範同時定義了 Event 介面以提供事件的上下文資訊,實作該介面的物件通常作為第一個參數傳入事件處理函式。
DOM 2 事件模型允許實作支援多個事件模組,並定義了三個基礎模組:低階、依賴裝置的模組,UI 邏輯事件模組(UIEvent),以及文件變化事件模組;滑鼠事件模組(MouseEvent)亦已定義。第三方實作在定義新事件類型時,名稱不得以大小寫無關的 DOM 字串開頭,該前綴保留給未來的 DOM 事件模組。
各瀏覽器在「綁定/解除事件監聽器的方法」、「事件物件的取得方式」以及「Event 物件的實作」三方面均存在差異。受影響的瀏覽器:所有瀏覽器。若直接使用某瀏覽器特有的屬性與方法,就可能造成相容性問題,導致報錯或功能失效。
只有 IE 與 Opera 支援 attachEvent / detachEvent。具體而言:IE6、IE7、IE8 不支援標準的 addEventListener / removeEventListener,只提供 attachEvent / detachEvent 作為替代;Opera 兩組都支援;Chrome、Safari、Firefox 只支援標準方法。
測試程式碼:
<button id="add" type="button">add event listener test</button>
<button id="remove" type="button">remove event listener test</button>
<div id="info"></div>
<script type="text/javascript">
var add = document.getElementById("add"),
remove = document.getElementById("remove"),
showMsgA = function(){showMsg("attachEvent")},
showMsgB = function(){showMsg("addEventListener")};
if(add.attachEvent){
add.attachEvent("onclick",showMsgA);
remove.attachEvent("onclick",removeE);
}
if(add.addEventListener){
add.addEventListener("click",showMsgB,false);
remove.addEventListener("click",removeE,false);
}
function removeE(){
if(add.detachEvent){
add.detachEvent("onclick",showMsgA);
showMsg("detachEvent");
}
if(add.removeEventListener){
add.removeEventListener("click",showMsgB,false);
showMsg("removeEventListener");
}
}
function showMsg(method){
document.getElementById("info").innerHTML += ("support " + method + "<br />");
}
</script>
測試結果:
IE6 / IE7 / IE8
Opera
Chrome / Safari / Firefox
attachEvent 也沒有參數可以指定是否於捕獲階段回應。DOM 2 Events 規定以監聽器的第一個參數作為事件物件;此外 IE、Opera、Chrome、Safari 還支援透過 window.event 取得。
<button type="button" id="attach">attachEvent</button>
<button type="button" id="addE">addEventListener</button>
<button type="button" id="byclick">onClick</button>
<br /> INFO : <div id="info"></div>
<script type="text/javascript">
function $(id){return document.getElementById(id);}
var attach = $("attach"), addE = $("addE"), byClick = $("byclick");
attach.attachEvent && attach.attachEvent("onclick", handler);
addE.addEventListener && addE.addEventListener("click", handler, false);
byClick.onclick = handler;
function handler(){
var src = window === this ? window.event.srcElement : this,
type = src.innerHTML;
window.event && showMsg(window.event.type, type + " + window.event");
arguments[0] && showMsg(arguments[0].type, type + " + arguments[0]");
}
function showMsg(type, msg){
$("info").innerHTML += (msg + "(type : " + type + ")<br />");
}
</script>
測試結果:
IE6 / IE7 / IE8
Chrome / Safari
Opera
Firefox
匯總結果:
| 事件物件取得方式 | IE6 / IE7 / IE8 | Chrome / Safari | Opera | Firefox |
|---|---|---|---|---|
window.event | Y | Y | Y | N |
arguments[0] | Y(部分支援) | Y | Y | Y |
Y 表示支援,N 表示不支援。從表中可歸納出:
attachEvent 註冊監聽器時,IE 才支援以第一個參數取得事件物件;若用 onclick = ... 指派,則只能透過 window.event。IE 對事件物件標準屬性與方法的支援相當有限,針對大部分項目都提供了自己的非標準替代方案;而 Firefox、Chrome、Safari、Opera 除了完整支援標準項目,還在不同程度上相容了 IE 的非標準寫法。
測試程式碼(節錄核心部分):
function $(id){return document.getElementById(id);}
// 跨瀏覽器綁定
function addEvent(elem, type, handler, useCapture){
elem.addEventListener ? elem.addEventListener(type, handler, useCapture)
: elem.attachEvent("on" + type, handler);
}
addEvent($("iEvent"), "click", handleEvent, false);
addEvent($("iUIMouse"), "click", handleUIMouse, false);
addEvent($("nosCM"), "click", handleNoSClick, false);
addEvent($("wrap"), "click", function(){alert("P tag.");}, false);
addEvent($("nosCM"), "mouseover", handldNoSMouse, false);
addEvent($("nosK"), "keydown", handleNoSKey, false);
function handleEvent(e){
e = e || window.event;
var props = { type:"type", target:"target", currentTarget:"currentTarget",
eventPhase:"eventPhase", bubbles:"bubbles", cancelable:"cancelable",
timeStamp:"timeStamp", initEvent:"initEvent",
preventDefault:"preventDefault", stopPropagation:"stopPropagation" };
showMsg(props, e, $("einfo"));
}
整理後的支援情況:
| 分類 | 屬性 / 方法 | IE6 / IE7 / IE8 | Chrome / Safari / Opera | Firefox |
|---|---|---|---|---|
| Interface Event | type | Y | Y | Y |
| target | N | Y | Y | |
| currentTarget | N | Y | Y | |
| eventPhase | N | Y | Y | |
| bubbles | N | Y | Y | |
| cancelable | N | Y | Y | |
| timeStamp | N | Y | Y | |
| initEvent | N | Y | Y | |
| preventDefault | N | Y | Y | |
| stopPropagation | N | Y | Y | |
| Interface UIEvent | view | N | Y | Y |
| detail | N | Y | Y | |
| initUIEvent | N | Y | Y | |
| Interface MouseEvent | screenX / screenY | Y | Y | Y |
| clientX / clientY | Y | Y | Y | |
| ctrlKey / shiftKey / altKey | Y | Y | Y | |
| metaKey | N | Y | Y | |
| button | Y | Y | Y | |
| relatedTarget | N | Y | Y | |
| initMouseEvent | N | Y | Y | |
| offsetX / offsetY | Y | Y | N | |
| returnValue | Y | Y | N | |
| srcElement | Y | Y | N | |
| x / y | Y | Y | N | |
| Non-standard | cancelBubble | Y | Y | Y |
| fromElement / toElement | Y | Y | N | |
| keyCode | Y | Y | Y | |
| srcElement(滑鼠事件) | Y | Y | N |
Y 代表支援,N 代表不支援。歸納結論:
type 外 Event 介面的任何屬性與方法,不支援 UIEvent 介面的任何項目,也不支援 MouseEvent 的 metaKey、relatedTarget 與 initMouseEvent。cancelBubble 與 keyCode。Firefox 不支援 returnValue。測試中雖然顯示其值為 false,但那只是因為我們替事件物件加了一個名為 returnValue 的屬性,實際上並沒有取消預設行為的作用——證據是網址列多了一個 #,那是 <a> 標籤 href 造成的。
timeStamp 的單位與起點各瀏覽器不同。IE 傳回的可能是自頁面載入以來的毫秒數,標準瀏覽器則多為 Unix epoch 毫秒數,跨瀏覽器進行時間差運算時務必先釐清基準。
function addEvent(elem, type, handler, useCapture){
elem.addEventListener ? elem.addEventListener(type, handler, useCapture)
: elem.attachEvent("on" + type, handler);
}
function removeEvent(elem, type, handler, useCapture){
elem.removeEventListener ? elem.removeEventListener(type, handler, useCapture)
: elem.detachEvent("on" + type, handler);
}
function handler(e){
e = e || window.event;
}
IE 雖然標準支援有限,但它自己那套事件模型大致能覆蓋標準功能。常見對照如下:
| 標準 | 非標準替代 |
|---|---|
| target | srcElement |
| preventDefault() | returnValue = false |
| stopPropagation() | cancelBubble = true |
| relatedTarget | fromElement / toElement |
| clientX | x |
| clientY | y |
把它包成一個統一的介面即可:
function getEventTarget(e){
e = e || window.event;
return e.target || e.srcElement;
}
function stopEvent(e){
e = e || window.event;
e.preventDefault ? e.preventDefault() : (e.returnValue = false);
e.stopPropagation ? e.stopPropagation() : (e.cancelBubble = true);
}
這份差異清單在當年是必要的知識,現在則已大幅簡化:IE6–IE8 已完全退出支援,所有現代瀏覽器都實作了 DOM Level 2/3 Events 與 Pointer Events。今天寫事件程式碼,只要注意三件事就夠了:addEventListener 一律帶第三個參數、event.target 直接可用、以及需要跨檔案型別時用 Pointer Events 取代分開處理 mouse 與 touch。上面那套相容層,只有在維護老舊系統時才需要拿出來。