一个 200 项的列表,给每项绑一个 click 监听器——这是最自然的写法,也是最容易在后期出问题的写法:列表刷新后,新项点不动了。

事件委托解决的不是性能,而是这个”新元素没有行为”的问题。

一、原理只有一句话

DOM 事件会从目标元素向上冒泡到根。所以你不监听子元素,而是监听它们的共同祖先,然后在回调里判断「这次到底点的是谁」。

JavaScript
1
2
3
4
5
6
7
8
9
10
11
// ❌ 每项一个监听器
document.querySelectorAll('.item').forEach(el => {
el.addEventListener('click', handleClick);
});

// ✅ 只绑一个,在祖先上判断
document.querySelector('.list').addEventListener('click', e => {
const item = e.target.closest('.item');
if (!item) return;
handleClick.call(item, e);
});

二、为什么新元素点不动

第一种写法的问题在于:querySelectorAll 返回的是调用那一刻的静态快照。之后插入的新 .item 从来没有被绑定过。

委托写法监听的是祖先 .list(它一直存在),判断逻辑在事件发生时才执行——不管子元素什么时候出现,都能命中。

这不是"优化",是正确性

很多人把事件委托当成性能技巧(”少绑 199 个监听器”)。性能收益确实存在但通常不关键。真正的价值是:对动态内容,非委托的写法根本就是错的。

无限滚动、分页刷新、异步加载的评论区——只要有元素会被替换,就该用委托。

三、三个必须处理的边界

边界一:e.target 可能不是你要的元素

点了 .item 里的 <span>,e.target 是那个 span,不是 .item。必须向上找:

JavaScript
1
const item = e.target.closest('.item');
不要用

e.target.parentElement.parentElement 这种写法在结构微调时会立刻失效。closest() 会一直向上找到最近的匹配祖先,结构怎么变都不影响。

边界二:委托元素本身也可能是目标

如果祖先自己也可能被点击,要一并处理:

JavaScript
1
2
3
4
list.addEventListener('click', e => {
if (e.target.closest('.item')) { /* 点了某一项 */ }
else if (e.target === list) { /* 点了空白区 */ }
});

边界三:不是所有事件都会冒泡

这几个不冒泡,委托无效:

事件 说明
focus / blur 不冒泡,用 focusin / focusout 代替
mouseenter / mouseleave 不冒泡,用 mouseover / mouseout
load / unload 不冒泡
scroll 在元素上不冒泡(document 上可以)
记忆方法

需要委托焦点事件时,写 focusin / focusout——它们语义相同但会冒泡,可以直接替换。这是最容易忘的一个。

四、用 data-* 属性把「做什么」写进 HTML

委托场景下,一个常见写法是把动作类型放在 data-* 上:

HTML
1
2
3
4
5
<div class="toolbar">
<button data-action="copy">复制</button>
<button data-action="share">分享</button>
<button data-action="delete">删除</button>
</div>
JavaScript
1
2
3
4
5
6
7
8
9
10
11
const actions = {
copy: () => navigator.clipboard.writeText(text),
share: () => shareIt(text),
delete: () => confirmThenDelete(id),
};

toolbar.addEventListener('click', e => {
const btn = e.target.closest('[data-action]');
if (!btn) return;
actions[btn.dataset.action]?.();
});

好处:新增一个按钮只需要加 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)。

七、移除监听器

委托的另一个好处:清理只需要一次。

JavaScript
1
2
3
// 直接绑定:要记住并逐个移除 200 个
// 委托:一行
list.removeEventListener('click', handler);

配合 AbortController 更省心:

JavaScript
1
2
3
4
const ac = new AbortController();
list.addEventListener('click', handler, { signal: ac.signal });
// 需要时:
ac.abort(); // 一次性解绑所有用这个 signal 注册的监听器