在 javascript 中,监听事件捕获阶段需要在使用 addeventlistener 注册事件处理函数时,将第三个参数 usecapture 设置为 true。默认情况下该参数为 false(即冒泡阶段),设为 true 后,当事件从文档根节点向下传播到目标元素时,浏览器会优先执行这些捕获阶段的监听器。

如何正确设置 useCapture 参数
要启用捕获阶段监听,只需在调用 addEventListener 时将第三个参数显式指定为 true。这告诉浏览器在当前元素上,当事件流处于捕获阶段时触发回调。例如,在父元素上监听子元素的点击事件,若希望先于子元素自身的冒泡监听器执行,必须使用捕获模式。此时,事件从 document 开始,依次经过祖先元素,最后到达目标元素。如果在祖先元素上设置了 useCapture: true,其处理函数会在事件到达目标之前被调用。

const parent = document.getElementById('parent');
const child = document.getElementById('child');
// 在父元素上添加捕获阶段监听器
parent.addEventListener('click', function(e) {
console.log('Parent Capture:', e.target.id);
}, true);
// 在子元素上添加冒泡阶段监听器(默认)
child.addEventListener('click', function(e) {
console.log('Child Bubble:', e.target.id);
}, false);
// 点击 child 时,输出顺序为:
// Parent Capture: child
// Child Bubble: child捕获与冒泡的执行顺序对比
理解捕获与冒泡的关键在于事件流的三个阶段:捕获阶段、目标阶段和冒泡阶段。当用户点击一个嵌套元素时,事件首先从 document 向下遍历至目标元素(捕获阶段),然后触发目标元素自身的事件(目标阶段),最后再向上冒泡回 document(冒泡阶段)。通过在不同阶段注册监听器,可以控制代码执行的时机。捕获阶段适合用于拦截或预处理事件,而冒泡阶段更适合用于响应事件。若在同一元素上同时注册了捕获和冒泡监听器,捕获阶段的监听器会先执行。这种机制允许开发者灵活地决定事件处理的优先级,例如在表单提交前进行全局验证,或在特定 UI 交互中提前阻止默认行为。
立即学习“Java免费学习笔记(深入)”;

// 演示完整事件流顺序
const doc = document;
const body = document.body;
const parent = document.getElementById('parent');
const child = document.getElementById('child');
// 各层均注册捕获和冒泡监听器
doc.addEventListener('click', () => console.log('Doc Capture'), true);
body.addEventListener('click', () => console.log('Body Capture'), true);
parent.addEventListener('click', () => console.log('Parent Capture'), true);
child.addEventListener('click', () => console.log('Child Target'), false); // 目标阶段
parent.addEventListener('click', () => console.log('Parent Bubble'), false);
body.addEventListener('click', () => console.log('Body Bubble'), false);
doc.addEventListener('click', () => console.log('Doc Bubble'), false);
// 点击 child 的输出顺序:
// Doc Capture
// Body Capture
// Parent Capture
// Child Target
// Parent Bubble
// Body Bubble
// Doc Bubble在捕获阶段调用 preventDefault 的效果
在事件捕获阶段调用 preventDefault() 可以阻止事件的默认行为,但其效果取决于具体事件类型和浏览器实现。对于某些可取消的事件(如 click、submit),如果在捕获阶段调用了 preventDefault(),则后续的目标阶段和冒泡阶段仍会执行,但默认行为(如页面跳转、表单提交)将被取消。需要注意的是,stopPropagation() 在捕获阶段调用会阻止事件继续向目标元素传播,这意味着目标元素及其后代上的任何监听器都不会被触发。因此,若在捕获阶段需要完全拦截事件,应结合使用 preventDefault() 和 stopPropagation()。例如,在父元素上捕获点击事件并调用 stopPropagation(),子元素上的所有监听器(无论是捕获还是冒泡)都不会被执行。


















