一个 200 项的列表,给每项绑一个 click 监听器——这是最自然的写法,也是最容易在后期出问题的写法:列表刷新后,新项点不动了。
事件委托解决的不是性能,而是这个”新元素没有行为”的问题。
一、原理只有一句话
DOM 事件会从目标元素向上冒泡到根。所以你不监听子元素,而是监听它们的共同祖先,然后在回调里判断「这次到底点的是谁」。
1 | // ❌ 每项一个监听器 |
二、为什么新元素点不动
第一种写法的问题在于:querySelectorAll 返回的是调用那一刻的静态快照。之后插入的新 .item 从来没有被绑定过。
委托写法监听的是祖先 .list(它一直存在),判断逻辑在事件发生时才执行——不管子元素什么时候出现,都能命中。
很多人把事件委托当成性能技巧(”少绑 199 个监听器”)。性能收益确实存在但通常不关键。真正的价值是:对动态内容,非委托的写法根本就是错的。
无限滚动、分页刷新、异步加载的评论区——只要有元素会被替换,就该用委托。
三、三个必须处理的边界
边界一:e.target 可能不是你要的元素
点了 .item 里的 <span>,e.target 是那个 span,不是 .item。必须向上找:
1 | const item = e.target.closest('.item'); |
e.target.parentElement.parentElement 这种写法在结构微调时会立刻失效。closest() 会一直向上找到最近的匹配祖先,结构怎么变都不影响。
边界二:委托元素本身也可能是目标
如果祖先自己也可能被点击,要一并处理:
1 | list.addEventListener('click', e => { |
边界三:不是所有事件都会冒泡
这几个不冒泡,委托无效:
| 事件 | 说明 |
|---|---|
focus / blur |
不冒泡,用 focusin / focusout 代替 |
mouseenter / mouseleave |
不冒泡,用 mouseover / mouseout |
load / unload |
不冒泡 |
scroll |
在元素上不冒泡(document 上可以) |
需要委托焦点事件时,写 focusin / focusout——它们语义相同但会冒泡,可以直接替换。这是最容易忘的一个。
四、用 data-* 属性把「做什么」写进 HTML
委托场景下,一个常见写法是把动作类型放在 data-* 上:
1 | <div class="toolbar"> |
1 | const actions = { |
好处:新增一个按钮只需要加 HTML,JS 完全不用动。行为表是数据,不是分支。
五、什么时候不该用委托
mousemove、scroll、input 这类每秒触发几十次的事件,委托到顶层会让回调执行次数暴涨。要么绑在具体元素上,要么自己做节流。
如果你的代码依赖 stopPropagation 做隔离(比如弹层内部点击不触发外部关闭),委托会让这套约定变得难推理。这类场景用直接绑定更清楚。
把监听器挂到 document 上虽然最省事,但每次点击都要走完整条冒泡路径并做匹配判断。挂到最近的共同祖先才是正确粒度。
六、本站的两个真实用例
文档侧栏树
侧栏有 50 条链接、8 个分组,每个分组的箭头都要能点击切换展开。委托到侧栏容器上,用 closest('.has-children') 判断,新增文档自动生效——不用为新节点重新绑定。
多语言切换
切换语言后要重渲染一批文案。委托到 document 上监听 click,用 closest('[data-lang]') 反查容器。这里踩过一个坑:选择器用 closest 时如果命中的是 <html> 本身(它也可能带这个属性),会导致全站链接点不动——匹配范围一定要限定在具体容器内。
closest() 会一路向上查到 <html>。如果根元素恰好带了同名的 data-* 属性(本站用于标记语言),匹配就会”永远命中”,于是所有点击都被当成语言切换处理掉。
委托时的匹配范围要收窄,必要时先判断 container.contains(target)。
七、移除监听器
委托的另一个好处:清理只需要一次。
1 | // 直接绑定:要记住并逐个移除 200 个 |
配合 AbortController 更省心:
1 | const ac = new AbortController(); |
评论