用 jQuery 綁定事件只要一行 .on(),但在原生 JavaScript 中卻得處理 addEventListener、跨瀏覽器相容、事件物件標準化等一堆細節。本文把這些方法逐一整理,並附上實測範例。
做播放器時遇到「監聽移除不掉」的問題,查了才知道原因:add 與 remove 的參數必須完全對應。
$('.video')[0].addEventListener('timeupdate', currentTimeHandler, true);
這句需要傳入三個參數才能被正確移除。add 和 remove 時第三個參數確實都可以省略,但此時兩邊的預設值雖然都是 false,只要其中一邊有寫、另一邊沒寫,瀏覽器就會認為不是同一組監聽器。養成三個參數都明確寫出的習慣,可以省下不少除錯時間。
var eventHandlesCounter = 1; // 統計添加事件監聽的個數,0 作為預留位
function addEvent(obj, evt, fn){
if(!fn.__EventID){ fn.__EventID = eventHandlesCounter++; }
if(!obj.__EventHandles){ obj.__EventHandles = []; }
if(!obj.__EventHandles[evt]){
obj.__EventHandles[evt] = [];
if(obj["on" + evt] instanceof Function){
obj.__EventHandles[evt][0] = obj["on" + evt];
obj["on" + evt] = handleEvents;
}
}
obj.__EventHandles[evt][fn.__EventID] = fn;
function handleEvents(){
var fns = obj.__EventHandles[evt];
for (var i = 0; i < fns.length; i++)
fns[i].call(this);
}
}
function delEvent(obj, evt, fn){
if(!obj.__EventHandles || !obj.__EventHandles[evt] || !fn.__EventID){
return false;
}
if(obj.__EventHandles[evt][fn.__EventID] == fn){
delete obj.__EventHandles[evt][fn.__EventID];
}
}
function addEvent(obj, evt, fn, useCapture){
if(obj.addEventListener){ // 優先使用 W3C 事件註冊
obj.addEventListener(evt, fn, !!useCapture);
} else {
if(!fn.__EventID){ fn.__EventID = addEvent.__EventHandlesCounter++; }
if(!obj.__EventHandles){ obj.__EventHandles = []; }
if(!obj.__EventHandles[evt]){
obj.__EventHandles[evt] = [];
if(obj["on" + evt]){
(obj.__EventHandles[evt][0] = obj["on" + evt]).__EventID = 0;
}
obj["on" + evt] = addEvent.execEventHandles;
}
obj.__EventHandles[evt][fn.__EventID] = fn;
}
}
addEvent.__EventHandlesCounter = 1;
addEvent.execEventHandles = function(evt){
if(!this.__EventHandles) { return true; }
evt = evt || window.event;
var fns = this.__EventHandles[evt.type];
for (var i = 0; i < fns.length; i++){
if(fns[i] instanceof Function){
fns[i].call(this);
}
}
};
function delEvent(obj, evt, fn, useCapture){
if (obj.removeEventListener) { // 先用 W3C 的方法移除事件處理函式
obj.removeEventListener(evt, fn, !!useCapture);
} else {
if(obj.__EventHandles){
var fns = obj.__EventHandles[evt];
if(fns){ delete fns[fn.__EventID]; }
}
}
}
function fixEvent(evt){
if(!evt.target){
evt.target = evt.srcElement;
evt.preventDefault = fixEvent.preventDefault;
evt.stopPropagation = fixEvent.stopPropagation;
if(evt.type == "mouseover"){
evt.relatedTarget = evt.fromElement;
} else if(evt.type == "mouseout"){
evt.relatedTarget = evt.toElement;
}
evt.charCode = (evt.type == "keypress") ? evt.keyCode : 0;
evt.eventPhase = 2;
evt.timeStamp = (new Date()).getTime();
}
return evt;
}
fixEvent.preventDefault = function(){ this.returnValue = false; };
fixEvent.stopPropagation = function(){ this.cancelBubble = true; };
fixEvent 不能單獨執行,它必須接收事件物件參數,而且只有在事件發生時才會被呼叫。最好的做法是把它整合進 addEvent.execEventHandles 裡:
addEvent.execEventHandles = function (evt) {
if (!this.__EventHandles) { return true; }
evt = fixEvent(evt || window.event); // 在這裡做標準化
var fns = this.__EventHandles[evt.type];
for (var i = 0; i < fns.length; i++) {
if (fns[i] instanceof Function) {
fns[i].call(this, evt); // 作為事件處理函式的第一個參數傳入
}
}
};
如此一來,在事件處理函式內部就能用統一的方式存取事件物件,不必再處處寫 evt = evt || window.event。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>test6.html</title>
<script type="text/javascript">
function test(){
window.alert("您投了一次票");
document.getElementById("1").detachEvent("onclick", test);
}
</script>
</head>
<body>
<input type="button" value="投票" id="1"/>
<script type="text/javascript">
document.getElementById("1").attachEvent("onclick", test);
</script>
</body>
</html>
這裡用 attachEvent 動態綁定,再用 detachEvent 動態取消,於是這個事件只會回應一次,之後再點按鈕不會有任何效果。若使用標準 API,對應的寫法是 addEventListener 搭配 removeEventListener,或更簡潔地掛上 { once: true } 選項。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>test7.html</title>
<script type="text/javascript">
function test(event){
// 用戶每按下一個按鍵,就去判斷是不是數字
if(event.keyCode < 48 || event.keyCode > 57){
window.alert("您輸入的不是一個數字");
return false;
}
}
</script>
</head>
<body>
<input type="text" onkeypress="return test(event);" />請輸入數字
</body>
</html>
這裡的 event 就是事件物件,它能提供大量資訊(按鍵碼、座標、目標元素等),細節可參考相關文件。以 ASCII 範圍 48–57 判斷是否為數字,是相當直白的做法;現代寫法則建議改用 event.key 並搭配 input 事件與正則驗證。
attachEvent/detachEvent 綁定與移除監聽器;W3C 使用 addEventListener/removeEventListener。on(如 onclick),W3C 則直接用 click。window.event,W3C 則把 event 物件作為參數傳入監聽器。event.returnValue = false,W3C 是呼叫 event.preventDefault()。event.cancelBubble = true,W3C 是呼叫 event.stopPropagation()。this 指向的是 window 而非觸發事件的物件。好消息是,以上差異在現代專案中已不需要處理。IE11 之後的環境全面支援標準事件模型,微軟也已停止對舊版 IE 的支援,直接寫 addEventListener 即可,並可用 AbortController 批次取消大量監聽器,省去逐一 remove 的麻煩。