DIV CSS 佈局教程網

JavaScript 事件綁定與移除:讓事件只生效指定次數
編輯:關於JavaScript     

「這個事件執行幾次之後就自動失效」是很實用的需求,例如首次點擊時顯示引導提示,之後就不再打擾使用者。要做到這件事,得先學會跨瀏覽器地綁定與移除事件。

跨瀏覽器的通用寫法

標準瀏覽器用 addEventListener / removeEventListener,舊版 IE 用 attachEvent / detachEvent,最後還要有一層直接指派 on* 屬性的退路。

// 綁定
function AddEventHandler(oTarget, sEventType, fnHandler) {
  if (oTarget.addEventListener) {            // 標準瀏覽器
    oTarget.addEventListener(sEventType, fnHandler, false);
  } else if (oTarget.attachEvent) {          // 舊版 IE
    oTarget.attachEvent('on' + sEventType, fnHandler);
  } else {                                   // 最後退路
    oTarget['on' + sEventType] = fnHandler;
  }
}

// 移除
function RemoveEventHandler(oTarget, sEventType, fnHandler) {
  if (oTarget.removeEventListener) {
    oTarget.removeEventListener(sEventType, fnHandler, false);
  } else if (oTarget.detachEvent) {
    oTarget.detachEvent('on' + sEventType, fnHandler);
  } else {
    oTarget['on' + sEventType] = null;
  }
}

這裡有個關鍵細節:移除時傳入的函式必須與綁定時是同一個參考。如果你寫成 addEventListener('click', function(){...}),之後就再也無法移除它,因為你手上沒有那個函式物件。這也是為什麼下面的範例要把處理函式先命名為 removeClick。

完整範例:點一次就失效

<script type="text/javascript">
var EventUtil = new Object;

EventUtil.addEvent = function (oTarget, sEventType, funName) {
  if (oTarget.addEventListener) {
    oTarget.addEventListener(sEventType, funName, false);
  } else if (oTarget.attachEvent) {
    oTarget.attachEvent("on" + sEventType, funName);
  } else {
    oTarget["on" + sEventType] = funName;
  }
};

EventUtil.removeEvent = function (oTarget, sEventType, funName) {
  if (oTarget.removeEventListener) {
    oTarget.removeEventListener(sEventType, funName, false);
  } else if (oTarget.detachEvent) {
    oTarget.detachEvent("on" + sEventType, funName);
  } else {
    oTarget["on" + sEventType] = null;
  }
};

function removeClick() {
  alert("click");
  var oDiv = document.getElementById("odiv");
  oDiv.style.cursor = "auto";
  EventUtil.removeEvent(oDiv, "click", removeClick);  // 自己把自己移除
}

function addLoadEvent(func) {
  var oldonload = window.onload;
  if (typeof window.onload != "function") {
    window.onload = func;
  } else {
    window.onload = function () { oldonload(); func(); };
  }
}

addLoadEvent(function () {
  var oDiv = document.getElementById("odiv");
  oDiv.style.cursor = "pointer";
  EventUtil.addEvent(oDiv, "click", removeClick);
});
</script>

<p>第一次點會跳出提示並移除 click 事件,再點就沒反應了</p>
<div id="odiv" style="background:#003399; height:70px; width:126px;
     margin:0 auto; color:skyblue;">第一次警告,第二次沒反應!</div>

今天該怎麼寫

舊 IE 早已退場,那三段 if/else 可以直接省掉,只用標準 API 就好。而「只執行一次」在現代寫法中有一現成的選項:

el.addEventListener('click', handler, { once: true });

需要綁定多個監聽器時,強烈建議改用 AbortController 一次全部解除,這比逐一記住函式參考優雅得多:

const ac = new AbortController();
el.addEventListener('click', fn, { signal: ac.signal });
el.addEventListener('mouseover', fn2, { signal: ac.signal });
ac.abort();   // 一次解除全部

至於 addLoadEvent 這種手動串接 onload 的技巧,現在請直接寫成 DOMContentLoaded 監聽,或在腳本上使用 defer / type="module"。

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