浏览器与 Web API / 系统课时

使用 addEventListener 监听事件

使用 addEventListener 监听事件

本课解决“怎样为元素稳定注册事件处理逻辑”这一问题。你将掌握事件类型、回调函数、重复注册判定与监听器移除,并通过一个可运行示例验证不同监听器的实际执行次数。

学习目标

  • 使用 addEventListener 为元素注册一个或多个事件监听器
  • 解释事件类型、回调引用与 capture 对重复注册的影响
  • 使用 removeEventListener 正确移除已注册的监听器

addEventListener 的注册规则

addEventListener(type, callback, options) 把一个回调登记到事件目标上。type 是不带 on 前缀的事件名,例如 click、input;callback 是事件发生时执行的函数;options 可以控制捕获阶段、只执行一次或是否声明为被动监听器。

同一个元素可以监听同一种事件的多个回调。浏览器只会忽略“事件类型相同、回调对象相同、capture 值相同”的重复注册。两个内容完全一样的匿名函数仍是不同函数对象,因此会分别执行。

完整示例:注册、触发与移除

下面的页面同时注册普通监听器、两个匿名监听器和一个 once 监听器。普通监听器被重复注册一次,但浏览器只保留一份。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>事件监听示例</title>
</head>
<body>
  <button id="trigger">触发事件</button>
  <button id="remove">移除普通监听器</button>
  <pre id="output">等待操作</pre>

  <script>
    const triggerButton = document.querySelector('#trigger');
    const removeButton = document.querySelector('#remove');
    const output = document.querySelector('#output');
    const records = [];

    function log(message) {
      records.push(message);
      output.textContent = records.join('\n');
    }

    function handleClick() {
      log('普通监听器');
    }

    triggerButton.addEventListener('click', handleClick);
    // 同一回调与同一捕获设置再次注册,不会新增一份监听器
    triggerButton.addEventListener('click', handleClick);

    triggerButton.addEventListener('click', () => log('匿名监听器 A'));
    triggerButton.addEventListener('click', () => log('匿名监听器 B'));
    triggerButton.addEventListener('click', () => log('once 监听器'), {
      once: true
    });

    removeButton.addEventListener('click', () => {
      // 移除时必须继续使用原来的函数引用
      triggerButton.removeEventListener('click', handleClick);
      log('普通监听器已移除');
    });
  </script>
</body>
</html>

预期结果。第一次点击“触发事件”后,页面显示:

text
普通监听器
匿名监听器 A
匿名监听器 B
once 监听器

再点击“移除普通监听器”,然后第二次点击“触发事件”,后续只会新增以下记录:

text
普通监听器已移除
匿名监听器 A
匿名监听器 B

监听选项与常见边界

{ once: true } 会在回调首次执行后自动移除监听器,适合一次性初始化。capture: true 表示在捕获阶段处理事件;省略时默认为 false,即通常在冒泡阶段执行。重复注册和移除监听器时,capture 是否一致是关键条件。

不要直接用临时匿名函数执行移除操作。removeEventListener('click', () => {}) 创建的是新函数,无法匹配之前注册的匿名回调。需要后续移除时,应先把函数保存到变量或声明为具名函数。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 addEventListener 监听事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通