1. 事件监听器入门:先搞懂addEventListener到底在干什么
如果你写过一阵子前端,那对addEventListener这三个单词一定不陌生。但说句实在话,很多同学用了一年半载,依然只会写“点击按钮弹出弹窗”这种最基础的用法,遇到事件传参、事件委托、自定义事件就有点发懵。这篇内容我打算把事件监听器里涉及到的event事件体系从头到尾梳理一遍,把常用的事件类型、事件对象的核心字段、浏览器底层的传播机制、以及日常开发中最容易踩的坑一次讲透。无论你是刚开始接触JavaScript的初学者,还是已经写过不少业务代码但一直没系统整理过事件知识的中级开发者,这篇都可以当一份案头手册来用。
先明确一个基本概念。addEventListener是DOM元素上注册事件监听器的标准方法,它接收三个参数:事件类型、回调函数、以及一个可选的配置对象。浏览器在捕获到用户交互(点击、按键、滚动)或者元素状态变化(加载完成、输入内容变化、失去焦点)时,会创建一个事件对象(也就是event),然后按照“捕获阶段—目标阶段—冒泡阶段”的顺序派发给对应的监听器。
这个机制听起来简单,但设计得非常精巧。事件对象里不仅包含了事件类型和触发元素,还挂载了一大堆和具体交互相关的信息,比如鼠标点击的坐标、按下的键盘按键、触摸点的数量、拖拽过程中的数据等等。把这些字段吃透,你能实现很多看起来很高级的交互效果,而且代码还能写得非常干净。
我个人的建议是:不要急着背事件列表,先理解事件是怎么产生的、怎么流动的,再看有哪些事件类型。底层机制通了,后面所有事件对你来说都只是“换个名字的事”。
1.1 addEventListener的第三个参数:不只是true/false
addEventListener的完整签名是这样:
javascript复制element.addEventListener(type, listener, options);
第三个参数可以传布尔值,也可以传一个配置对象。很多老教程只会告诉你“true是捕获,false是冒泡”,但你要真的只记到这个程度,后面肯定踩坑。因为在现代浏览器里,第三个参数最常见的用法其实是下面这几种:
javascript复制// 1. 只在首次触发时执行一次,之后自动移除
button.addEventListener('click', handleClick, { once: true });
// 2. 让监听器在捕获阶段执行
button.addEventListener('click', handleClick, { capture: true });
// 3. 标记为被动监听,告诉浏览器“我不会调用preventDefault”
window.addEventListener('touchmove', handleTouch, { passive: true });
// 4. 通过AbortSignal取消监听
const controller = new AbortController();
button.addEventListener('click', handleClick, { signal: controller.signal });
// 某个时机下,一次性移除该信号关联的所有监听器
controller.abort();
其中passive这个配置特别值得展开说。移动端页面滚动的时候,浏览器需要预先知道touchmove这类事件里有没有调用过preventDefault,如果每个touchmove监听器都同步执行完才能决定是否滚动,滚动性能会变得非常差。设置passive: true等于告诉浏览器:放心滚,我不会阻止默认行为。Chrome在2016年之后就把window、document和body上的touchmove、wheel默认改成passive了,这也是为什么你在某些监听器里调用preventDefault会看到“无法阻止默认行为”的警告。
那什么时候用捕获,什么时候用冒泡?我给你的建议很简单:默认用冒泡(false),只有在事件委托确实处理不了的场景下才考虑捕获。捕获阶段主要用于一些必须在元素自身处理前就截获事件的场景,比如全局点击拦截、拖拽面板的mousedown拦截,或者处理多个嵌套元素的鼠标进入离开逻辑。
1.2 为什么不用onclick,而是用addEventListener
这个问题我面试的时候经常问候选人,很多人答不上来。归根结底,onclick这类属性式绑定存在两个硬伤:第一,同一个元素的同一个事件只能绑定一个处理函数,后面赋值的会覆盖前面的;第二,无法精细控制事件在哪一阶段触发。
javascript复制// 属性绑定的覆盖问题
button.onclick = function () { console.log('第一次绑定'); };
button.onclick = function () { console.log('第二次绑定'); };
// 点击时只会输出“第二次绑定”
// addEventListener则可以叠加
button.addEventListener('click', function () { console.log('第一次绑定'); });
button.addEventListener('click', function () { console.log('第二次绑定'); });
// 点击时会依次输出“第一次绑定”“第二次绑定”
这两个差别在真实项目里影响很大。比如多个模块都要监听同一个按钮的点击事件,用onclick就会出现后写的模块把前面的覆盖掉,或者你得手写一个回调数组来管理;用addEventListener就完全没这个负担,甚至同一个函数可以同时绑在被监听元素的不同事件上。
另外一个细节是,addEventListener的回调函数在调用时,this指向的是绑定监听器的那个元素,而不是window。这一点和React合成事件里的行为不一样,做事件处理器封装的时候要注意,别在回调里随手写一个箭头函数就把this搞丢了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 事件类型全景:一张表看全前端主流event事件
进入正题之前要说明一点,这里说的“事件”指的是浏览器原生事件类型,不是自定义事件。前端开发中真正高频用到的事件,大概可以分成鼠标、键盘、表单、焦点、触摸指针、滚动、拖拽、剪贴板、媒体、网络和生命周期这几大类。
我把日常开发里最常用的事件类型整理成了下面这张表,强烈建议你收藏,写代码的时候对照着查:
| 事件大类 | 具体事件 | 触发时机 | 典型使用场景 |
|---|---|---|---|
| 鼠标 | click | 鼠标点击 | 按钮提交、导航跳转 |
| 鼠标 | dblclick | 鼠标双击 |
