如何用javascript创建自定义事件？如何触发和监听？

风之吻网站开发 2025-12-14 95

　　JavaScript 中创建和使用自定义事件很简单，核心是 CustomEvent 构造函数 + dispatchEvent 触发 + addEventListener 监听。

如何用javascript创建自定义事件？如何触发和监听？-第1张图片-风享汇

　　创建自定义事件

　　用 CustomEvent 构造函数创建事件对象，可传入事件名和配置对象，其中 detail 字段用来携带任意数据：

　　　 new CustomEvent('myEvent', { detail: { id: 123, msg: 'hello' } })

　　　 detail 可以是字符串、数字、对象、数组，甚至函数（注意跨 iframe 时函数会丢失）

　　如果不需要传参，可省略配置对象： new CustomEvent('myEvent')

　　触发自定义事件

　　调用目标元素（或 document 、 window ）的 dispatchEvent 方法：

　　 element.dispatchEvent(event) —— 元素上触发

　　 document.dispatchEvent(event) —— 全局广播（适合跨组件通信）

　　事件会按 DOM 冒泡规则向上冒泡（除非设置 bubbles: false ）

　　默认不取消冒泡，也不可被阻止（除非显式设置 cancelable: true ）

　　监听自定义事件

　　用标准的 addEventListener 监听，事件名与创建时一致：

　　 element.addEventListener('myEvent', handler)

　　回调函数中通过 e.detail 获取传递的数据： e.detail.id、e.detail.msg

　　支持捕获阶段监听： element.addEventListener('myEvent', handler, true)

　　记得在不需要时用 removeEventListener 清理，避免内存泄漏

　　一个完整小例子

　　按钮点击后触发自定义事件，父容器监听并打印数据：

// 创建事件
const event = new CustomEvent('dataReady', {
  detail: { user: 'Alice', score: 95 },
  bubbles: true
});

// 触发（比如在按钮点击里）
document.getElementById('btn').addEventListener('click', () => {
  document.body.dispatchEvent(event);
});

// 监听
document.body.addEventListener('dataReady', (e) => {
  console.log('收到数据：', e.detail); // { user: 'Alice', score: 95 }
});

　　基本上就这些。不复杂但容易忽略细节，比如忘记传 detail 或没调用 dispatchEvent 。

标签： javascript