讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

JavaScript 事件捕获与冒泡中事件对象怎么获取完整传播路径

陌萱小哥_6067

陌萱小哥_6067

发布时间:2026-11-18 12:46:31

|

143人浏览过

|

来源于php中文网

原创

在 javascript 事件捕获与冒泡中,获取完整传播路径的核心做法是:利用 event 对象的 eventphase 属性结合 currenttarget 属性,在事件流经过的每个节点上收集信息。具体而言,监听器需同时注册在目标元素的祖先节点(用于捕获阶段)和目标元素自身及其祖先(用于冒泡阶段),并在回调中通过 event.currenttarget 识别当前处理事件的节点,通过 event.eventphase 区分阶段(1为捕获,2为目标,3为冒泡),最终将所有经过的节点按时间顺序存入数组即可得到完整路径。

JavaScript 事件捕获与冒泡中事件对象怎么获取完整传播路径

如何区分捕获与冒泡阶段的节点

要区分这两个阶段,关键在于理解 eventPhase 的值以及监听器的注册方式。捕获阶段从 window 向下传播到目标父节点,此时 eventPhase 为 1;冒泡阶段从目标节点向上传播到 window,此时 eventPhase 为 3。目标节点本身在两个阶段都会触发,但通常被视为一个单独的状态,eventPhase 为 2。为了获取完整路径,必须在所有相关层级都添加监听器,且捕获阶段的监听器必须设置第三个参数为 true。这样,当事件发生时,浏览器会先执行所有捕获阶段的监听器,再执行目标节点的监听器,最后执行所有冒泡阶段的监听器。通过记录每次触发时的 currentTarget 和 eventPhase,就能构建出完整的传播序列。

JavaScript 事件捕获与冒泡中事件对象怎么获取完整传播路径

const path = [];

function trackEvent(event) {
  const node = event.currentTarget;
  const phase = event.eventPhase;
  // 避免重复记录目标节点(因为目标节点在捕获和冒泡边界可能被视为特殊)
  // 这里我们简单地将所有经过的节点加入路径
  path.push({
    node: node,
    phase: phase === 1 ? 'capture' : (phase === 2 ? 'target' : 'bubble')
  });
}

// 假设有一个嵌套结构: #window > #parent > #child
// 我们需要在所有祖先上注册监听器

// 捕获阶段监听器
window.addEventListener('click', trackEvent, true);
document.body.addEventListener('click', trackEvent, true);
const parent = document.getElementById('parent');
if(parent) parent.addEventListener('click', trackEvent, true);

// 目标节点监听器(不指定第三参数,默认为false,即冒泡阶段,但也会作为目标触发)
const child = document.getElementById('child');
if(child) {
  child.addEventListener('click', trackEvent);
}

// 冒泡阶段监听器(显式注册,虽然默认就是冒泡,但为了清晰)
// 注意:如果已经在上面注册了捕获,这里需要确保冒泡也能被捕获
// 实际上,上面的 window/body/parent 注册的是捕获,所以它们不会在冒泡阶段触发
// 因此,我们需要额外注册冒泡阶段的监听器,或者只依赖默认行为
// 更简单的做法是:在所有节点上都注册两种监听器,或者只注册一种并手动模拟

// 修正方案:为了确保完整路径,我们在每个节点都注册捕获和冒泡监听器
// 但为了避免重复,我们可以只在每个节点注册一次,并根据 eventPhase 判断
// 然而,标准做法是:
// 1. 祖先节点注册 capture: true
// 2. 目标节点注册 capture: false (默认)
// 3. 祖先节点如果需要也在冒泡阶段记录,需再次注册 capture: false

// 简化版:只记录经过的节点,不严格区分是否重复,只要顺序对即可
// 实际开发中,通常只需要知道哪些节点参与了,以及它们的阶段

// 重新设计:在每个节点上注册两个监听器,一个捕获,一个冒泡
// 但这样会导致目标节点被记录两次(一次作为捕获阶段的终点,一次作为冒泡阶段的起点)
// 更好的方式是:使用一个 Set 来去重,或者接受这种细微差别

// 最终代码:
const fullPath = [];

function recordPhase(event) {
  const { currentTarget, eventPhase } = event;
  let phaseName;
  if (eventPhase === 1) phaseName = 'CAPTURE';
  else if (eventPhase === 2) phaseName = 'TARGET';
  else phaseName = 'BUBBLE';
  
  fullPath.push(`${currentTarget.tagName || currentTarget} (${phaseName})`);
}

// 为所有相关元素注册捕获和冒泡监听器
['window', 'document', 'body', 'parent', 'child'].forEach(id => {
  let el = id === 'window' ? window : (id === 'document' ? document : document.getElementById(id));
  if (!el) return;
  
  // 捕获阶段
  el.addEventListener('click', recordPhase, true);
  // 冒泡阶段
  el.addEventListener('click', recordPhase, false);
});

// 触发点击 child
// child.click(); // 模拟触发

// 预期输出示例:
// HTML (CAPTURE)
// BODY (CAPTURE)
// PARENT (CAPTURE)
// CHILD (TARGET)
// PARENT (BUBBLE)
// BODY (BUBBLE)
// HTML (BUBBLE)

上述代码展示了如何在每个节点上同时注册捕获和冒泡监听器。当点击 #child 时,事件会从 window 开始,依次经过 document、body、parent,到达 child,然后反向冒泡回去。由于我们在每个节点都注册了两种类型的监听器,因此 fullPath 数组将包含所有经过的节点及其对应的阶段。需要注意的是,目标节点 child 会被记录两次:一次作为捕获阶段的最后一个节点(eventPhase 为 1,但实际上目标节点在捕获阶段结束时触发,其 eventPhase 仍为 1?不,根据规范,目标节点的 eventPhase 始终为 2,无论它是捕获还是冒泡的一部分。这是一个常见的误解。让我们澄清一下:
- 捕获阶段:从根到目标的父节点,eventPhase 为 1。
- 目标阶段:目标节点本身,eventPhase 为 2。
- 冒泡阶段:从目标的父节点到根,eventPhase 为 3。
因此,在上述代码中,child 的捕获监听器不会被触发,因为捕获阶段在到达 child 之前就结束了。只有 child 的冒泡监听器(作为目标)会被触发,且 eventPhase 为 2。而 parent 的捕获监听器会在捕获阶段触发(eventPhase 为 1),parent 的冒泡监听器会在冒泡阶段触发(eventPhase 为 3)。所以,正确的路径应该是:
1. window (CAPTURE)
2. document (CAPTURE)
3. body (CAPTURE)
4. parent (CAPTURE)
5. child (TARGET)
6. parent (BUBBLE)
7. body (BUBBLE)
8. document (BUBBLE)
9. window (BUBBLE)
这确保了每个节点都被正确记录,并且阶段准确无误。

如何处理目标节点的特殊情况

目标节点在事件传播中具有特殊性,它的 eventPhase 始终为 2,既不属于捕获也不属于冒泡。这意味着,即使你在目标节点上注册了捕获监听器(addEventListener(..., true)),它也不会以捕获阶段的方式触发,而是以目标阶段的方式触发。同样,冒泡监听器也以目标阶段的方式触发。因此,在处理目标节点时,不需要担心它会出现在捕获或冒泡列表中,它总是独立出现。此外,如果目标节点有多个监听器,它们会按照注册顺序依次执行。为了获取完整路径,只需在目标节点上注册一个监听器,并记录其 currentTarget 和 eventPhase 即可。其他节点则分别注册捕获和冒泡监听器,以确保它们在各自的阶段被记录。这种方法避免了重复记录,并保证了路径的完整性。

JavaScript规范工具(免费版)
JavaScript规范工具(免费版)

面向个人开发者的JavaScript代码风格指南,涵盖核心规则与基础代码审查能力。

下载

立即学习“Java免费学习笔记(深入)”;

JavaScript 事件捕获与冒泡中事件对象怎么获取完整传播路径

// 针对目标节点的特殊处理示例
const targetNode = document.getElementById('child');
const captureListeners = [];
const bubbleListeners = [];

// 为所有祖先节点注册捕获和冒泡监听器
function registerAncestors(node) {
  let current = node.parentElement;
  while (current && current !== document.documentElement) {
    // 捕获阶段
    const captureHandler = (e) => {
      captureListeners.push({
        node: e.currentTarget,
        phase: 'CAPTURE'
      });
    };
    current.addEventListener('click', captureHandler, true);
    
    // 冒泡阶段
    const bubbleHandler = (e) => {
      bubbleListeners.push({
        node: e.currentTarget,
        phase: 'BUBBLE'
      });
    };
    current.addEventListener('click', bubbleHandler, false);
    
    current = current.parentElement;
  }
}

registerAncestors(targetNode);

// 为目标节点注册监听器
targetNode.addEventListener('click', (e) => {
  captureListeners.push({
    node: e.currentTarget,
    phase: 'TARGET'
  });
  bubbleListeners.push({
    node: e.currentTarget,
    phase: 'TARGET'
  });
}, false); // 注意:这里用 false,但实际触发时 eventPhase 为 2

// 合并路径
const fullPath = [...captureListeners, ...bubbleListeners];
// 注意:上述代码中,目标节点被添加了两次,一次在 captureListeners,一次在 bubbleListeners
// 这是因为我们在目标节点上注册了一个监听器,但它同时影响了两个数组
// 更好的做法是:只在一个数组中添加目标节点,或者在合并时去重

// 修正后的合并逻辑
const finalPath = [];
captureListeners.forEach(item => {
  if (!finalPath.some(p => p.node === item.node && p.phase === item.phase)) {
    finalPath.push(item);
  }
});
bubbleListeners.forEach(item => {
  if (!finalPath.some(p => p.node === item.node && p.phase === item.phase)) {
    finalPath.push(item);
  }
});

// 预期输出:
// [{node: window, phase: 'CAPTURE'}, {node: document, phase: 'CAPTURE'}, ..., {node: child, phase: 'TARGET'}, ..., {node: window, phase: 'BUBBLE'}]

这段代码专门处理了目标节点的情况。通过 registerAncestors 函数,我们为所有祖先节点注册了捕获和冒泡监听器。对于目标节点,我们只注册了一个监听器,但在合并路径时,将其同时添加到捕获和冒泡列表中,并标记为 TARGET 阶段。最后,通过去重逻辑,确保每个节点-阶段组合只出现一次。这种方法虽然稍微复杂,但能准确反映事件传播的实际过程。在实际应用中,可以根据需求简化逻辑,例如只关心节点而不关心阶段,或者只关心特定阶段的节点。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

6046

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

1449

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

5944

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

1080

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2056

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

4085

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

5413

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

3560

2023.09.20

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn