DIV CSS 佈局教程網

JavaScript 事件監聽的綁定與移除完全解析
編輯:JavaScript綜合知識     

用 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];
  }
}

三、修正版:優先採用 W3C 標準,向下相容 IE

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 事件與正則驗證。

IE 與 W3C 事件模型的八個差異

  1. IE 使用 attachEvent/detachEvent 綁定與移除監聽器;W3C 使用 addEventListener/removeEventListener。
  2. IE 的事件名稱前綴為 on(如 onclick),W3C 則直接用 click。
  3. IE 在監聽器內使用全域的 window.event,W3C 則把 event 物件作為參數傳入監聽器。
  4. 要阻止預設行為,IE 是設定 event.returnValue = false,W3C 是呼叫 event.preventDefault()。
  5. IE 不支援事件捕捉階段。
  6. 要停止事件傳遞,IE 是設定 event.cancelBubble = true,W3C 是呼叫 event.stopPropagation()。
  7. IE 把監聽器當成獨立函式呼叫,因此監聽器內的 this 指向的是 window 而非觸發事件的物件。
  8. IE 在事件監聽上存在記憶體洩漏問題:若為某元素建立監聽器並在監聽器中使用該元素,在使用者離開頁面前,該監聽器與相關 DOM 節點佔用的記憶體不會被釋放。

好消息是,以上差異在現代專案中已不需要處理。IE11 之後的環境全面支援標準事件模型,微軟也已停止對舊版 IE 的支援,直接寫 addEventListener 即可,並可用 AbortController 批次取消大量監聽器,省去逐一 remove 的麻煩。

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