大网数据广告活动
Web 标准与前端开发

Event

· 52CE 我爱测

一些事件是由用户触发的,例如鼠标或键盘事件;或者由 API 生成以表示异步任务的进度。事件也可以通过编程方式触发,例如对元素调用 `HTMLElement.click()` 方法,或者定义一些自定义事件,再使用 `EventTarget.dispatchEvent()` 方法将自定义事件派发往指定的目标(target)。

DOM

Event 接口表示在 EventTarget 上出现的事件。

一些事件是由用户触发的,例如鼠标或键盘事件;或者由 API 生成以表示异步任务的进度。事件也可以通过编程方式触发,例如对元素调用 HTMLElement.click() 方法,或者定义一些自定义事件,再使用 EventTarget.dispatchEvent() 方法将自定义事件派发往指定的目标(target)。

有许多不同类型的事件,其中一些使用基于 Event 主接口的其他接口。Event 本身包含适用于所有事件的属性和方法。

很多 DOM 元素可以被设计接收 (或者监听) 这些事件,并且执行代码去响应(或者处理)它们。通过 EventTarget.addEventListener() 方法可以将事件处理器绑定到不同的 HTML 元素上(比如 <button>、<div>、<span> 等等)。这种方式基本替换了老版本中使用 HTML 事件处理器属性的方式。此外,在正确添加后,还可以使用 removeEventListener() 方法移除这些事件处理器。

[!NOTE] 一个元素可以绑定多个事件处理器,甚至是对于完全相同的事件。尤其是相互独立的代码模块出于不同的目的附加事件处理器。(比如,一个网页同时有着广告模块和统计模块同时监听视频播放。)

当有很多嵌套的元素,每个元素都有着自己的事件处理器,事件处理过程会变得非常复杂。尤其当一个父元素和子元素绑定完全相同的事件时,因为结构上的重叠,事件在技术层面发生在两个元素中,触发的顺序取决于每个处理器的事件冒泡的设置。

基于 Event 的接口

下面是基于 Event 主接口的接口列表,每一个接口都设置了指向各自的 MDN API 参考中相应文档的链接。

需要注意的是,所有的事件接口名称都是以“Event”结尾的。

  • AnimationEvent
  • AudioProcessingEvent
  • BeforeUnloadEvent
  • BlobEvent
  • ClipboardEvent
  • CloseEvent
  • CompositionEvent
  • CustomEvent
  • DeviceMotionEvent
  • DeviceOrientationEvent
  • DragEvent
  • ErrorEvent
  • FetchEvent
  • FocusEvent
  • FontFaceSetLoadEvent
  • FormDataEvent
  • GamepadEvent
  • HashChangeEvent
  • HIDInputReportEvent
  • IDBVersionChangeEvent
  • InputEvent
  • KeyboardEvent
  • MediaStreamEvent
  • MessageEvent
  • MouseEvent
  • MutationEvent
  • OfflineAudioCompletionEvent
  • PageTransitionEvent
  • PaymentRequestUpdateEvent
  • PointerEvent
  • PopStateEvent
  • ProgressEvent
  • RTCDataChannelEvent
  • RTCPeerConnectionIceEvent
  • StorageEvent
  • SubmitEvent
  • TimeEvent
  • TouchEvent
  • TrackEvent
  • TransitionEvent
  • UIEvent
  • WebGLContextEvent
  • WheelEvent

构造函数

  • Event.Event
    • : 创建并返回一个 Event 对象。

实例属性

  • Event.bubbles
    • : 一个布尔值,用来表示该事件是否会在 DOM 中冒泡。
  • Event.cancelable
    • : 一个布尔值,表示事件是否可以取消。
  • Event.composed
    • : 一个布尔值,表示事件是否可以穿过 Shadow DOM 和常规 DOM 之间的边界进行冒泡。
  • Event.currentTarget
    • : 对事件当前注册的目标的引用。这是一个当前计划将事件发送到的对象。它是有可能在重定向(retarget)的过程中被改变的。
  • Event.defaultPrevented
    • : 一个布尔值,表示 event.preventDefault() 方法是否取消了事件的默认行为。
  • Event.eventPhase
    • : 指示正在处理的事件流阶段。它是以下数字之一:NONE、CAPTURING_PHASE、AT_TARGET、BUBBLING_PHASE。
  • Event.isTrusted
    • : 表示事件是由浏览器(例如用户点击)发起的,还是由脚本发起的(例如使用事件创建方法)。
  • Event.target
    • : 对最初分发事件的对象的引用。
  • Event.timeStamp
    • : 事件创建时的时间戳(精度为毫秒)。按照规范,这个时间戳是 Unix 纪元起经过的毫秒数,但实际上,在不同的浏览器中,对此时间戳的定义也有所不同。另外,规范正在将其修改为 DOMHighResTimeStamp。
  • Event.type
    • : 事件的类型的名称。

遗留属性和非标准属性

  • Event.cancelBubble
    • : Event.stopPropagation() 的历史别名,应该改用。在事件处理程序返回之前将其值设置为 true 可以阻止事件传播。
  • Event.explicitOriginalTarget
    • : 事件的明确原始目标。
  • Event.originalTarget
    • : 重定向目标前的事件原始目标。
  • Event.returnValue
    • : 为了确保现有网站继续工作,而仍然支持的历史属性。请改用 Event.preventDefault() 和 Event.defaultPrevented。
  • Event.composed
    • : 一个布尔值,指示给定事件是否会穿过影子根节点冒泡到标准 DOM。请改用 Event.composed。

实例方法

  • Event.composedPath()
    • : 返回事件的路径(将在该对象上调用监听器)。如果阴影根(shadow root)节点创建时 ShadowRoot.mode 值为 closed,那么路径不会包括该根节点下影子树(shadow tree)的节点。
  • event.preventDefault
    • : 取消事件(如果该事件可取消)。
  • event.stopImmediatePropagation
    • : 对这个特定的事件而言,没有其他监听器被调用。这个事件既不会添加到相同的元素上,也不会添加到以后将要遍历的元素上(例如在捕获阶段)。
  • event.stopPropagation
    • : 停止冒泡,阻止事件在 DOM 中继续冒泡。

弃用方法

  • Event.initEvent()
    • : 初始化创建的事件的值。如果事件已经被分派,则此方法不执行任何操作。请改用构造函数(Event.Event)。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。