1. 事件监听器入门:addEventListener 必须重新认识的几个细节
先问一个问题:你平时写事件绑定,是不是还停留在 button.onclick = handler 这种阶段?如果是,那我建议你把文章继续往下看。addEventListener 已经流行了十多年,但我见过太多人只用了它最基本的“注册函数”功能,完全忽略了这个 API 背后真正有价值的设计。
先说清楚它解决什么问题。页面上任何一个交互动作——点击、键盘输入、光标移动、窗口缩放、表单提交——在浏览器内部都会变成一个“事件对象”,而 addEventListener 就是用来告诉浏览器“这个事件发生时,帮我执行某个回调函数”的标准方式。它要解决的核心痛点有三个:同一事件可以挂多个处理函数、可以主动移除监听、可以控制事件是冒泡还是捕获阶段触发。这三件事是 onclick = fn 这种老写法做不到的。
适合谁看?刚接触前端准备系统梳理事件机制的初学者,写了两三年业务代码但对事件流、事件委托一知半解的开发者,以及面试前临时抱佛脚的同学。这篇文章不会只罗列事件名称,我会把每个事件类型背后的触发条件、常见场景、实际踩坑全部拆开讲。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. addEventListener 基础用法:语法、参数和几个容易忽略的细节
2.1 参数结构:不只是“事件名 + 回调函数”
标准语法是:
javascript复制target.addEventListener(type, listener, options);
target.addEventListener(type, listener, useCapture);
target 是事件源,type 是事件名字符串,listener 是回调函数或者实现了 handleEvent 方法的对象。第三个参数最关键,大多数人以为这里只能传布尔值,实际上现代浏览器都支持传一个 options 对象。
options 对象可以包含四个字段:
javascript复制element.addEventListener('click', handler, {
capture: false, // 是否在捕获阶段触发,默认 false,冒泡阶段触发
once: false, // 是否只触发一次后自动移除,默认 false
passive: false, // 是否不调用 preventDefault,默认 false
signal: AbortSignal // 可选,传入 AbortSignal 用于取消监听
});
capture 控制的是监听器在事件流哪个阶段执行,这是事件机制的基础,后面专门讲。once: true 很适合支付按钮、一次性初始化、登录页跳转这类场景——你既想保证事件只响应第一次,又不想手动写 removeEventListener,直接加 once 省掉一行代码。
真正麻烦的是 passive。它的作用跟滚动性能优化直接相关:当你在 touchstart、touchmove、wheel 这类滚动事件上调用 preventDefault() 时,浏览器并不确定你最终会不会阻止默认行为,它只能先等 JS 执行完再决定是否滚动,这就导致滚动出现明显延迟。设置 passive: true 等于告诉浏览器“我肯定不会阻止默认行为”,你可以放心滚动。
注意:Chrome 从 56 版本开始,把
window、document、document.body上的touchstart和touchmove默认设为passive: true。如果你在这类事件里调用preventDefault()想阻止滚动,控制台会报Unable to preventDefault inside passive event listener invocation。解法是显式传{ passive: false }。
2.2 removeEventListener 为什么“删不掉”监听器
removeEventListener 的语法是 target.removeEventListener(type, listener)。这里有个核心约束:删除时传入的 listener 必须和添加时是同一个引用。
也就是说,下面这种写法是删不掉的:
javascript复制button.addEventListener('click', function() {
console.log('clicked');
});
button.removeEventListener('click', function() {
console.log('clicked');
});
第二次传入的是一个全新的匿名函数,和第一次注册的不是同一个对象,引用不相等,移除操作无效。错误率非常高。正确做法是把函数提出来赋给变量:
javascript复制function handleClick() {
console.log('clicked');
}
button.addEventListener('click', handleClick);
button.removeEventListener('click', handleClick);
另外还有一个细节:如果通过 addEventListener 添加监听器时传了 options.capture,那么移除时也要传相同的 capture 才能匹配。默认情况下 removeEventListener 的第三个参数如果省略,相当于 capture: false,如果添加时用了 capture: true,直接 removeEventListener(type, fn) 是移除不掉的。这个问题我见过不少老手也中招。
2.3 为什么不建议用 onclick/onxxx 属性绑定
再看一个对比。onclick = handler 的写法本质上是在元素的监听器回调集合上覆盖赋值,同一个事件你写两次,前面的会被后面的覆盖。而 addEventListener 天然支持同一事件挂
