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