萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript addEventListener 事件監聽完全指南:現代事件綁定最佳實踐

為什麼要用 addEventListener?

傳統 onclick 等屬性綁定方式存在嚴重缺陷:

  • 覆蓋問題: 同一元素同一事件只能綁定一個處理器,後綁定者覆蓋前者
  • 無法移除: 匿名函數無法通過引用移除
  • 無捕獲階段: 只支持冒泡階段
  • this 指向問題: 內聯屬性中 this 指向不穩定

addEventListener (IE9+/現代瀏覽器) 完美解決這些問題,是現代 Web 開發標準。

語法詳解

target.addEventListener(type, listener[, options]);
target.addEventListener(type, listener[, useCapture]); // 舊版語法
參數類型說明
typestring事件類型(如 "click", "keydown", "submit"),不帶 "on" 前綴
listenerFunction/EventListener事件處理函數,接收 Event 對象
optionsObject{ capture: Boolean, once: Boolean, passive: Boolean }
useCaptureBoolean舊版:true=捕獲階段,false=冒泡階段(默認)

options 詳細說明

  • capture: true — 在捕獲階段觸發(由外向內)
  • once: true — 處理器執行一次後自動移除
  • passive: true — 聲明不調用 preventDefault(),瀏覽器可優化滾動/觸摸性能

基礎範例:點擊彈窗

<!DOCTYPE html>
<html lang="zh-TW">
<head>
    <meta charset="UTF-8">
    <title>addEventListener 演示</title>
</head>
<body>
    <div id="main">
        <p id="target">點擊我試試</p>
        <p>你點不到我(無綁定)</p>
    </div>

    <script>
        function showAlert() {
            alert('你點擊了我!');
        }

        function bindClick() {
            var pElement = document.getElementsByTagName('p')[0];
            // 綁定點擊事件,冒泡階段(默認)
            pElement.addEventListener('click', showAlert, false);
        }

        // 頁面加載完成後綁定
        window.addEventListener('load', bindClick, false);
    </script>
</body>
</html>

核心優勢演示

1. 多處理器共存(不覆蓋)

var btn = document.getElementById("btn");

btn.addEventListener("click", function() { console.log("處理器 1"); });
btn.addEventListener("click", function() { console.log("處理器 2"); });
btn.addEventListener("click", function() { console.log("處理器 3"); });

// 點擊輸出:處理器 1 → 處理器 2 → 處理器 3(按綁定順序)

2. 移除特定處理器

function handler1() { console.log("1"); }
function handler2() { console.log("2"); }

btn.addEventListener("click", handler1);
btn.addEventListener("click", handler2);

// 移除 handler1,保留 handler2
btn.removeEventListener("click", handler1);

// ❌ 錯誤:匿名函數無法移除(引用不同)
btn.addEventListener("click", function() { console.log("A"); });
btn.removeEventListener("click", function() { console.log("A"); }); // 無效!

// ✅ 正確:使用命名函數/變量引用
var handlerA = function() { console.log("A"); };
btn.addEventListener("click", handlerA);
btn.removeEventListener("click", handlerA); // 有效

3. once 選項:一次性監聽

btn.addEventListener("click", function() {
    console.log("只會執行一次");
}, { once: true });

4. passive 選項:滾動性能優化

// 滾動/觸摸事件默認 passive: true(現代瀏覽器)
// 若需 preventDefault,必須顯式 passive: false
document.addEventListener('touchstart', function(e) {
    e.preventDefault(); // 需要防止默認行為
}, { passive: false });

事件流:捕獲 → 目標 → 冒泡

<div id="grandparent">
    <div id="parent">
        <button id="child">點擊</button>
    </div>
</div>

<script>
["grandparent", "parent", "child"].forEach(function(id) {
    var el = document.getElementById(id);
    // 捕獲階段
    el.addEventListener("click", function(e) {
        console.log("捕獲:", id, "target:", e.target.id, "currentTarget:", e.currentTarget.id);
    }, true);
    // 冒泡階段
    el.addEventListener("click", function(e) {
        console.log("冒泡:", id, "target:", e.target.id, "currentTarget:", e.currentTarget.id);
    }, false);
});
</script>

點擊按鈕,輸出順序:

捕獲: grandparent
捕獲: parent
捕獲: child
冒泡: child
冒泡: parent
冒泡: grandparent

停止傳播

// 停止冒泡(不影響同元素其他處理器)
e.stopPropagation();

// 停止冒泡 + 禁止同元素其他處理器
e.stopImmediatePropagation();

// 阻止默認行為(如鏈接跳轉、表單提交)
e.preventDefault();

// 組合:return false(僅在 jQuery/內聯處理器中等效於以上兩者)

跨瀏覽器兼容封裝(IE8 支持)

var EventUtil = {
    addHandler: function(element, type, handler) {
        if (element.addEventListener) {
            element.addEventListener(type, handler, false);
        } else if (element.attachEvent) { // IE8-
            element.attachEvent("on" + type, handler);
        } else {
            element["on" + type] = handler; // DOM0 級降級
        }
    },
    removeHandler: function(element, type, handler) {
        if (element.removeEventListener) {
            element.removeEventListener(type, handler, false);
        } else if (element.detachEvent) {
            element.detachEvent("on" + type, handler);
        } else {
            element["on" + type] = null;
        }
    },
    getEvent: function(event) {
        return event || window.event;
    },
    getTarget: function(event) {
        return event.target || event.srcElement;
    },
    preventDefault: function(event) {
        if (event.preventDefault) event.preventDefault();
        else event.returnValue = false;
    },
    stopPropagation: function(event) {
        if (event.stopPropagation) event.stopPropagation();
        else event.cancelBubble = true;
    }
};

// 使用
EventUtil.addHandler(btn, "click", function(e) {
    var event = EventUtil.getEvent(e);
    var target = EventUtil.getTarget(event);
    console.log("點擊:", target.tagName);
});

現代最佳實踐清單

  1. 優先使用 addEventListener,棄用 onclick 屬性
  2. 命名處理器函數,便於移除與調試
  3. 善用 { once: true } 處理一次性交互(如模態框關閉、埋點上報)
  4. 滾動/觸摸事件添加 { passive: true }(默認已開啟),需 preventDefault 時顯式 passive: false
  5. 事件委託: 父元素綁定,利用冒泡處理子元素(動態列表、大量元素)
  6. 清理: 組件銷毀時 removeEventListener,防內存洩漏
  7. 避免在循環中綁定: 使用事件委託或提取函數引用

總結

addEventListener 是現代 JavaScript 事件處理的基石。它解決了舊模式的所有痛點,支持捕獲/冒泡控制、多處理器共存、一次性監聽、被動監聽等高級特性。配合事件對象的標準化 API(target, currentTarget, preventDefault, stopPropagation),構成了健壯、可維護交互邏輯的基礎。徹底拋棄 onclick,擁抱標準事件模型吧!

copyright © 萬盛學電腦網 all rights reserved