UI事件

1. 介绍

1.1. 概述

UI Events 设计有两个主要目标。第一个目标是设计一个 事件 系统，该系统允许注册 事件监听器， 并描述事件在树结构中的流动方式。此外，本规范将为用户界面控制和文档变更通知提供标准事件模块，并为这些事件模块定义相关的上下文信息。

UI Events 的第二个目标是提供当前主流浏览器所用事件系统的通用子集，旨在促进现有脚本和内容的互操作性。并不期望该目标能实现完全的向后兼容，但规范会在可能时予以实现。

1.2. 一致性

本节为规范性内容。

在本规范中，关键词 MUST、MUST NOT、REQUIRED、SHALL、SHALL NOT、SHOULD、SHOULD NOT、RECOMMENDED、MAY 与 OPTIONAL 应按 [RFC2119] 所述进行解释。

本规范应结合 DOM Level 3 Core 规范 [DOM-Level-3-Core] 理解，并适用 DOM 实现的一般考虑。例如，命名空间 URI 的处理在 XML 命名空间 中讨论。有关 一致性 的更多信息，请参见 DOM Level 3 Core 规范 [DOM-Level-3-Core]。用户代理 无需完全符合其他规范即可符合本规范，但必须符合本规范所引用的其他规范的相关部分（例如，符合 UI Events 的 用户代理 必须支持 DOMString 数据类型（见 [WebIDL]），但不需要支持 [WebIDL] 中的所有方法或数据类型才能符合 UI Events）。

本规范为不同的 用户代理、规范及内容作者定义了多种一致性类别：

1.2.1. 网页浏览器及其他动态或交互式 用户代理

动态或交互式 用户代理（以下简称“浏览器”，包括 Web 浏览器、辅助技术（AT）应用程序或其他类似程序）符合 UI Events 的要求，如果其支持：

• [DOM-Level-3-Core] 中定义的 Core 模块

• 本规范中定义的所有接口和事件及其相关方法、属性和语义，除标记为 弃用 的部分（符合要求的用户代理可为兼容旧内容实现弃用的接口、事件或 API，但并非必须实现才能符合要求）

• UI Events KeyboardEvent key 值与 code 值规范 [UIEvents-Key] 及 [UIEvents-Code] 中定义的所有 key 与 code 值（视平台可用性而定）

• 本规范中定义的所有其他规范性要求。

符合要求的浏览器在满足某 事件分发 的条件时，必须将事件分发至相应的 EventTarget 。

浏览器若实现本文件中规定的接口及相关 事件类型 ，则被视为符合 UI Events。

符合要求的浏览器必须支持脚本、声明式交互或其他可检测与分发事件的方式，并且必须支持所规定 事件类型 的相关 API。

除需满足所有其他一致性标准外，符合要求的浏览器可为兼容旧内容实现标记为 弃用 的功能，但不建议这样做。

符合要求的浏览器还可支持本规范未涵盖但使用本规范定义的接口、事件或其他特性的功能，并可实现额外接口及相关 事件类型。这些功能可在未来规范中标准化。

未能符合本规范所有必需部分的浏览器不得宣称符合 UI Events。仅部分符合本规范的实现可声明符合相关部分。

符合要求的浏览器还必须是本规范中 IDL 片段的符合实现，详见 Web IDL 规范 [WebIDL]。

1.2.2. 创作工具

内容创作工具如其生成的内容使用本规范中定义的 事件类型 且符合规范要求，则视为符合 UI Events。

内容创作工具不得宣称其生成的内容符合 UI Events，若该内容使用了本规范中标记为 弃用 的特性。

符合要求的内容创作工具应为内容作者提供使用所有相关 事件类型 和接口的方式，以适应所创作文档的所有 宿主语言。

1.2.3. 内容作者与内容

内容作者如其创作的内容使用本规范规定的 事件类型 且符合规范要求，则视为符合 UI Events。

内容作者不应使用本规范标记为 弃用 的特性，而应采用本规范及其他规范所定义的替代机制。

符合要求的内容必须按照本规范描述的接口及 事件类型 语义进行使用。

建议内容作者遵循 可访问性 与 国际化 指南规范中的最佳实践。

1.2.4. 规范与宿主语言

某规范或宿主语言 如其引用并使用本规范或 [DOM] 中定义的事件流机制、接口、事件或其他特性，且未以不兼容的方式扩展这些特性，则视为符合 UI Events。

某规范或宿主语言 如其引用并使用本文件规定的接口及相关 事件类型，则视为专门符合 UI Events。符合要求的规范可定义额外接口和相关 事件类型，或可以不违背或冲突于本规范相关接口及 事件类型 定义的方式扩展 UI Events 相关内容。

引用 UI Events 的规范或宿主语言 不应使用或推荐本规范标记为 弃用 的特性，而应使用或推荐相关替代机制（如有）。

2. 风格约定

本规范遵循 W3C 规范建议约定， 并补充如下：

• 印在按键上的 键帽 显示为 ↓、 = 或 Q。用于从用户角度引用按键，而不考虑生成的 key 和 code 在 KeyboardEvent 中的值。

• 表示字符的字形显示为："𣧂"。

• Unicode 字符编码显示为：U+003d。

• 按键按下生成的按键值名称（即 KeyboardEvent.key 的值）显示为： "ArrowDown"、 "="、"q" 或 "Q"。

• 与物理按键相关的按键代码名称（即 KeyboardEvent.code 的值）显示为： "ArrowDown"、 "Equal" 或 "KeyQ"。

此外，本规范中某些术语有特定含义。术语 实现 指实现本规范的浏览器、内容创作工具或其他 用户代理， 而内容作者是指编写脚本或代码、利用规范中描述的接口、方法、属性、事件和其他特性来创建 Web 应用的人员，用户则是指在实现中使用这些 Web 应用的人。

最后：

这是一个备注。

这是一个未解决的问题。

这是一个警告。

interface Example {
    // 这是一个 IDL 定义。
};

3. 基础事件接口

[DOM] 中定义的基础事件接口是 UI Events 的基础。这些基础事件接口在实现中必须始终被支持：

• Event 接口及其以下常量、方法和属性：

  • NONE 常量

  • CAPTURING_PHASE 常量

  • AT_TARGET 常量

  • BUBBLING_PHASE 常量

  • type 属性

  • target 属性

  • currentTarget 属性

  • eventPhase 属性

  • bubbles 属性

  • cancelable 属性

  • composed 属性

  • timeStamp 属性

  • defaultPrevented 属性

  • isTrusted 属性

  • stopPropagation() 方法

  • stopImmediatePropagation() 方法

  • preventDefault() 方法

  • initEvent() 方法

• CustomEvent 接口及其以下方法和属性：

  • initCustomEvent() 方法

  • detail 属性

• EventTarget 接口及其以下方法：

  • addEventListener() 方法

  • removeEventListener() 方法

  • dispatchEvent() 方法

• EventListener 接口及其 handleEvent() 方法

• Document 接口的 createEvent() 方法

本规范定义的事件类型均派生自上述基础接口，且必须继承其所有属性、方法和常量。

下图描述了本规范所述接口的继承关系结构。

3.1. 事件类型列表

每个事件必须关联一个类型，称为事件类型，可通过事件对象的 type 属性获取。事件类型必须为 DOMString 类型。

根据 DOM 支持级别或用于显示（如屏幕）或交互（如鼠标、键盘、触摸屏或语音）的设备，事件类型可由实现生成。当与 [XML] 或 [HTML5] 应用配合使用时，这些语言的规范可能会限制事件类型的语义和作用范围（尤其是可能的 事件目标）。请参阅所用语言的规范以获取这些限制或查找未在本文件中定义的事件类型。

下表为本规范所述事件类型的说明性摘要。

关于本规范中弃用事件列表，请见文末附录旧版事件类型。

以下是对上表的一种解读方式：load 事件会在 Element 节点的捕获和目标阶段触发为该事件注册的 事件监听器。该事件不可取消。如果为 load 事件在 Window、Document 或 Element 节点之外的节点注册事件监听器，或者仅注册在冒泡阶段，则该 事件监听器不会被触发。

不要将上表视为所有列出事件类型的权威说明。例如，load 事件在其他规范中也有应用，如 XMLHttpRequest。同样，dispatchEvent() 可用于向 任何 同样实现了 EventTarget 的对象分发非可信事件。

上述事件类型相关的事件对象包含更多上下文信息——详情请参见 DOM 接口描述。

3.2. 用户界面事件

用户界面事件模块包含与用户界面和文档操作相关的基本事件类型。

3.2.1. UIEvent 接口

在 DOM Level 2 中引入

UIEvent 接口提供了与用户界面事件相关的特定上下文信息。

要创建 UIEvent 接口的实例，可使用 UIEvent 构造函数，并传递可选的 UIEventInit 字典。

对于新定义的事件，不必仅因事件与用户界面相关就继承 UIEvent 接口。仅在 UIEventInit 的成员对这些事件有意义时才继承。

3.2.1.1. UIEvent

[Exposed=Window]
interface UIEvent : Event {
  constructor(DOMString type, optional UIEventInit eventInitDict = {});
  readonly attribute Window? view;
  readonly attribute long detail;
};

UIEvent . view

view 属性用于标识事件生成的 Window。

该属性的 未初始化值必须为 null。

UIEvent . detail

指定关于该 Event 的一些详细信息，具体取决于事件类型。

该属性的 未初始化值必须为 0。

3.2.1.2. UIEventInit

dictionary UIEventInit : EventInit {
  Window? view = null;
  long detail = 0;
};

UIEventInit . view

应初始化为该事件将被分发的全局环境的 Window 对象。如果事件将分发到某元素，则 view 属性应设为包含该元素 ownerDocument 的 Window 对象。

UIEventInit . detail

此值初始化为应用相关的数字。

3.2.2. UIEvent 算法

3.2.3. UIEvent 类型

用户界面事件类型如下所列。其中一些事件如果由用户界面生成，则使用 UIEvent 接口，否则使用 Event 接口，具体见各事件说明。

3.2.3.1. load

当 DOM 实现完成资源（如文档）及其任何依赖资源（如图片、样式表或脚本）加载时，用户代理必须分发该事件。未能成功加载的依赖资源不会阻止该事件触发，只要加载它们的资源仍可通过 DOM 访问。如果分发了该事件类型，要求实现至少在 Document 节点上分发该事件。

出于兼容旧版的原因，文档内部资源（如图片）的 load 事件在 HTML 实现中不会包含 Window 于传播路径。更多信息见 [HTML5]。

3.2.3.2. unload

当 DOM 实现从环境中移除资源（如文档）或任何依赖资源（如图片、样式表、脚本）时，用户代理必须分发该事件。该事件类型分发后，文档必须被卸载。如果分发了该事件类型，要求实现至少在 Document 节点上分发该事件。

3.2.3.3. abort

当某资源加载被中止（如用户在加载过程中取消加载），用户代理必须分发该事件。

3.2.3.4. error

当某资源加载失败，或已加载但无法根据语义解释（如图片无效、脚本执行错误或 XML 非格式良好），用户代理必须分发该事件。

3.2.3.5. select

当用户选择了某些文本后，用户代理必须分发该事件。该事件在选择行为发生后分发。

本规范不提供访问选中文本的上下文信息。适用时，应由 宿主语言定义用户如何选择内容（要考虑国际语言惯例）、select 事件分发的时机，以及内容作者如何访问用户选中的内容。

内容作者要访问用户选中的内容，可使用 宿主语言的原生能力，例如 HTML 编辑 API 的 Document.getSelection() 方法 [Editing]。

select 事件未必在所有语言的所有元素上都可用。例如，在 [HTML5] 中，select 事件仅可在表单 input 和 textarea 元素上分发。实现可在任何认为合适的上下文分发 select 事件，包括表单控件外的文本选择，或如 SVG 的图像或标记选择。

3.3. 焦点事件

本接口及其相关事件类型与 § 3.3.2 焦点事件顺序 是根据 用户代理可访问性指南 2.0 [UAAG20] 的概念及指引设计的，尤其关注了 焦点机制 及词汇表中关于 focus 的定义。

3.3.1. FocusEvent 接口

本规范中引入

FocusEvent 接口提供了与焦点事件相关的特定上下文信息。

要创建 FocusEvent 接口实例，可使用 FocusEvent 构造函数，并传递可选 FocusEventInit 字典。

3.3.1.1. FocusEvent

[Exposed=Window]
interface FocusEvent : UIEvent {
  constructor(DOMString type, optional FocusEventInit eventInitDict = {});
  readonly attribute EventTarget? relatedTarget;
};

FocusEvent . relatedTarget

用于标识与焦点事件相关的次级 EventTarget，具体取决于事件类型。

出于嵌套浏览上下文的安全考虑，切换到或离开嵌套上下文时，相关 EventTarget 应为 null。

该属性的 未初始化值必须为 null。

3.3.1.2. FocusEventInit

dictionary FocusEventInit : UIEventInit {
  EventTarget? relatedTarget = null;
};

FocusEventInit . relatedTarget

relatedTarget 应初始化为失去焦点的元素（用于 focus 或 focusin 事件）或获得焦点的元素（用于 blur 或 focusout 事件）。

3.3.2. 焦点事件顺序

本规范定义的焦点事件按一定顺序发生。下列为当焦点在元素间切换时的典型事件序列（假设最初没有元素获得焦点）：

本规范未定义与 focus() 或 blur() 等方法交互时的焦点事件行为，相关行为请见这些方法定义的规范。

3.3.3. 文档焦点与焦点上下文

本事件模块包含用于通知文档 焦点变化的事件类型。相关讨论涉及三种不同的焦点上下文：

• 操作系统焦点上下文，可能在计算机上运行的众多不同应用程序中的一个。获得焦点的应用程序之一可以是浏览器。

• 当浏览器获得焦点时，用户可以在不同浏览器用户界面字段之间切换（如通过 Tab 键），即 应用焦点上下文（如网站地址栏、搜索框等），其中之一可以是标签页中显示的文档。

• 当文档本身获得焦点时，文档焦点上下文可以设置为文档中的任何可获得焦点的元素。

本规范定义的事件类型仅处理文档焦点，事件详情中标识的 事件目标必须是窗口内文档或文档的一部分，不能是浏览器或操作系统的一部分，即使是焦点上下文之间切换时也如此。

通常，文档总是有一个获得焦点的元素（即使是文档元素本身），且有持久的 焦点环。在切换焦点上下文时，文档当前获得焦点的元素和焦点环通常保持原状。例如，若文档有三个可获得焦点的元素，第二个被聚焦，用户切换操作系统焦点到其他应用再切回浏览器，第二个元素仍在文档内获得焦点，Tab 键会将焦点切换到第三个元素。宿主语言可以定义哪些元素可以获得焦点、元素可获得焦点的条件、焦点切换的方式及顺序。例如，某些情况下可通过指针悬停获得焦点，其他情况则需鼠标点击。有些元素可能根本不可获得焦点，有些只可通过特定方式（如点击）获得，而不可 Tab 切换。文档可包含多个焦点环。其他规范可以定义比本规范更复杂的焦点模型，包括允许多个元素同时获得当前焦点。

3.3.4. 焦点事件类型

焦点事件类型如下所列。

3.3.4.1. blur

当某 用户代理检测到 事件目标失去焦点时，必须分发该事件。必须在该元素失去焦点后再分发本事件类型。该事件类型类似于 focusout，但不冒泡。

3.3.4.2. focus

当某 用户代理检测到 事件目标获得焦点时，必须分发该事件。必须在该元素获得焦点后再分发本事件类型。该事件类型类似于 focusin，但不冒泡。

3.3.4.3. focusin

当某 用户代理检测到 事件目标获得焦点时，必须分发该事件。该 事件目标必须是获得焦点的元素。focus 事件必须在本事件分发前触发。该事件类型类似于 focus，但会冒泡。

3.3.4.4. focusout

当某 用户代理检测到 事件目标失去焦点时，必须分发该事件。该 事件目标必须是失去焦点的元素。blur 事件必须在本事件分发前触发。该事件类型类似于 blur，但会冒泡。

3.4. 鼠标事件

鼠标事件模块起源于 [HTML401] 的 onclick、ondblclick、 onmousedown、onmouseup、onmouseover、onmousemove、 onmouseout 属性。此事件模块专为指针输入设备（如鼠标或轨迹球）设计。

3.4.1. MouseEvent 接口

在 DOM Level 2 中引入，本规范中有所修改

MouseEvent 接口提供了与鼠标事件相关的特定上下文信息。

在嵌套元素的情况下，鼠标事件总是针对最深层嵌套的元素。

目标元素的祖先可以通过事件冒泡获取其后代元素内发生的鼠标事件通知。

要创建 MouseEvent 接口实例，可使用 MouseEvent 构造函数，并传递可选的 MouseEventInit 字典。

使用 MouseEvent 的 initMouseEvent 初始化对象时，实现可利用 clientX 和 clientY 计算其他坐标（如 DOM Level 0 或其它专有属性暴露的目标坐标，例如 pageX）。

3.4.1.1. MouseEvent

[Exposed=Window]
interface MouseEvent : UIEvent {
  constructor(DOMString type, optional MouseEventInit eventInitDict = {});
  readonly attribute long screenX;
  readonly attribute long screenY;
  readonly attribute long clientX;
  readonly attribute long clientY;
  readonly attribute long layerX;
  readonly attribute long layerY;

  readonly attribute boolean ctrlKey;
  readonly attribute boolean shiftKey;
  readonly attribute boolean altKey;
  readonly attribute boolean metaKey;

  readonly attribute short button;
  readonly attribute unsigned short buttons;

  readonly attribute EventTarget? relatedTarget;

  boolean getModifierState(DOMString keyArg);
};

screenX, 类型为 long, 只读

事件发生时相对于屏幕坐标原点的水平坐标。

该属性的 未初始化值必须为 0。

screenY, 类型为 long, 只读

事件发生时相对于屏幕坐标原点的垂直坐标。

该属性的 未初始化值必须为 0。

clientX, 类型为 long, 只读

事件发生时相对于事件关联的视口的水平坐标。

该属性的 未初始化值必须为 0。

clientY, 类型为 long, 只读

事件发生时相对于事件关联的视口的垂直坐标。

该属性的 未初始化值必须为 0。

layerX, 类型为 long, 只读

距离最近的 祖先 元素的水平偏移， 该祖先元素是 堆叠上下文、定位元素， 或在 绘制堆叠上下文的定位阶段绘制。

该属性的 未初始化值必须为 0。

layerY, 类型为 long, 只读

距离最近的 祖先 元素的垂直偏移， 该祖先元素是 堆叠上下文、定位元素， 或在 绘制堆叠上下文的定位阶段绘制。

该属性的 未初始化值必须为 0。

ctrlKey, 类型为 boolean, 只读

参见 KeyboardEvent 的 ctrlKey 属性。

该属性的 未初始化值必须为 false。

shiftKey, 类型为 boolean, 只读

参见 KeyboardEvent 的 shiftKey 属性。

该属性的 未初始化值必须为 false。

altKey, 类型为 boolean, 只读

参见 KeyboardEvent 的 altKey 属性。

该属性的 未初始化值必须为 false。

metaKey, 类型为 boolean, 只读

参见 KeyboardEvent 的 metaKey 属性。

该属性的 未初始化值必须为 false。

button, 类型为 short, 只读

鼠标事件由鼠标按钮按下或释放引发时，button 必须用于指示哪个指针设备按钮状态发生了变化。

button 属性的值必须如下：

• 0 表示设备主按钮（一般为左键，或单键设备上的唯一按钮，用于激活控件或选择文本）或未初始化值。

• 1 表示辅助按钮（一般为中键，常与鼠标滚轮结合使用）。

• 2 表示次级按钮（一般为右键，常用于显示上下文菜单）。

• 3 表示 X1（后退）按钮。

• 4 表示 X2（前进）按钮。

部分指针设备提供或模拟更多按钮状态，超过 2 或小于 0 的值可表示这些按钮。

button 的值不会在非由鼠标按钮按下/释放引发的事件中更新，此时请勿将 0 解释为左键，而应视为未初始化值。

某些与 mousedown、mouseup 等事件相关的 默认行为 依赖于具体鼠标按钮。

该属性的 未初始化值必须为 0。

buttons, 类型为 unsigned short, 只读

在任何鼠标事件中，buttons 必须用于指示当前被按下的鼠标按钮组合，以位掩码表示。

虽然名称类似，buttons 与 button 的值完全不同。button 在 mousedown / mouseup 事件处理期间为有效值，buttons 属性则反映任意可信 MouseEvent 对象的鼠标按钮状态（分发期间），包括“无按钮激活”状态（0）。

buttons 属性值必须如下：

• 0 表示当前无按钮激活。

• 1 表示设备主按钮（一般为左键，或单键设备上的唯一按钮，用于激活控件或选择文本）。

• 2 表示次级按钮（一般为右键，常用于显示上下文菜单，如有）。

• 4 表示辅助按钮（一般为中键，常与鼠标滚轮结合使用）。

部分指针设备提供或模拟更多按钮。要表示这些按钮，值需依次加倍（二进制序列 8、16、32、...）。

任意按钮值组合之和唯一，内容作者可用位操作判断当前被按下的按钮数及具体按钮，适用于任意数量的鼠标按钮。例如 3 表示左键和右键同时按下，5 表示左键和中键同时按下。

某些与 mousedown、mouseup 等事件相关的 默认行为 依赖于具体鼠标按钮。

该属性的 未初始化值必须为 0。

relatedTarget, 类型为 EventTarget, 只读, 可为 null

用于标识与 UI 事件相关的次级 EventTarget，具体取决于事件类型。

该属性的 未初始化值必须为 null。

getModifierState(keyArg)

本规范中引入

使用按键值查询修饰键状态。

如果为修饰键且已激活则返回 true，否则返回 false。

DOMString keyArg

参见 KeyboardEvent 的 getModifierState() 方法参数说明。

3.4.1.2. MouseEventInit

dictionary MouseEventInit : EventModifierInit {
  long screenX = 0;
  long screenY = 0;
  long clientX = 0;
  long clientY = 0;

  short button = 0;
  unsigned short buttons = 0;
  EventTarget? relatedTarget = null;
};

screenX, 类型为 long，默认值为 0

初始化 screenX 属性为鼠标指针在用户屏幕上的期望水平相对位置。

将事件对象初始化为给定鼠标位置时，不应移动用户的鼠标指针到该初始化位置。

screenY, 类型为 long，默认值为 0

初始化 screenY 属性为鼠标指针在用户屏幕上的期望垂直相对位置。

将事件对象初始化为给定鼠标位置时，不应移动用户的鼠标指针到该初始化位置。

clientX, 类型为 long，默认值为 0

初始化 clientX 属性为鼠标指针在用户浏览器客户端窗口的期望水平位置。

将事件对象初始化为给定鼠标位置时，不应移动用户的鼠标指针到该初始化位置。

clientY, 类型为 long，默认值为 0

初始化 clientY 属性为鼠标指针在用户浏览器客户端窗口的期望垂直位置。

将事件对象初始化为给定鼠标位置时，不应移动用户的鼠标指针到该初始化位置。

button, 类型为 short，默认值为 0

初始化 button 属性为鼠标按钮的期望状态所对应的数字。

数值 0 代表主鼠标按钮，1 代表辅助/中间按钮，2 代表右键。大于 2 的数字也可能出现，但本文档未作规定。

buttons, 类型为 unsigned short，默认值为 0

初始化 buttons 属性为一个数字，表示要视为激活状态的一个或多个鼠标按钮。

buttons 属性为位字段，掩码值为 1 时表示主按钮按下，2 时表示右键按下，4 时表示辅助/中键按下。

在 JavaScript 中，如需初始化 buttons 属性为右键（2）和中键（4）同时按下，可赋值为：
{ buttons: 2 | 4 }
或
{ buttons: 6 }

relatedTarget, 类型为 EventTarget，可为 null，默认值为 null

relatedTarget 应初始化为鼠标指针刚离开的元素（对于 mouseover 或 mouseenter 事件），或鼠标指针即将进入的元素（对于 mouseout、 mouseleave 或 focusout 事件）。其他事件无需赋值（默认即为 null）。

实现在生成鼠标事件时必须维护 当前点击计数，其必须为非负整数，表示在特定时间内指针设备按钮的连续点击次数。计数重置的延迟取决于环境配置。

3.4.2. 事件修饰符初始化器

MouseEvent 和 KeyboardEvent 接口共享一组键盘修饰符属性，并支持检索额外修饰符状态的机制。下述字典允许作者初始化 MouseEvent 和 KeyboardEvent 接口的键盘修饰符属性，以及通过 getModifierState() 查询的其他修饰符状态。 使用该字典构造事件的步骤定义在 MouseEvent 构造器小节。

dictionary EventModifierInit : UIEventInit {
  boolean ctrlKey = false;
  boolean shiftKey = false;
  boolean altKey = false;
  boolean metaKey = false;

  boolean modifierAltGraph = false;
  boolean modifierCapsLock = false;
  boolean modifierFn = false;
  boolean modifierFnLock = false;
  boolean modifierHyper = false;
  boolean modifierNumLock = false;
  boolean modifierScrollLock = false;
  boolean modifierSuper = false;
  boolean modifierSymbol = false;
  boolean modifierSymbolLock = false;
};

ctrlKey, 类型为 boolean，默认值为 false

初始化 ctrlKey 属性为 MouseEvent 或 KeyboardEvent 对象，如果 Control 键修饰符应视为激活则为 true，否则为 false。

为 true 时，实现还必须初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Control 时返回 true。

shiftKey, 类型为 boolean，默认值为 false

初始化 shiftKey 属性为 MouseEvent 或 KeyboardEvent 对象，如果 Shift 键修饰符应视为激活则为 true，否则为 false。

为 true 时，实现还必须初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Shift 时返回 true。

altKey, 类型为 boolean，默认值为 false

初始化 altKey 属性为 MouseEvent 或 KeyboardEvent 对象，如果 Alt（备用）键（或 Option）修饰符应视为激活则为 true，否则为 false。

为 true 时，实现还必须初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Alt 时返回 true。

metaKey, 类型为 boolean，默认值为 false

初始化 metaKey 属性为 MouseEvent 或 KeyboardEvent 对象，如果 Meta 键修饰符应视为激活则为 true，否则为 false。

为 true 时，实现还必须初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Meta 时返回 true。

modifierAltGraph, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 AltGraph 时返回 true。

modifierCapsLock, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 CapsLock 时返回 true。

modifierFn, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Fn 时返回 true。

modifierFnLock, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 FnLock 时返回 true。

modifierHyper, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Hyper 时返回 true。

modifierNumLock, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 NumLock 时返回 true。

modifierScrollLock, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 ScrollLock 时返回 true。

modifierSuper, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Super 时返回 true。

modifierSymbol, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 Symbol 时返回 true。

modifierSymbolLock, 类型为 boolean，默认值为 false

初始化事件对象的键修饰状态，使得调用 getModifierState() 或 getModifierState() 并传入参数 SymbolLock 时返回 true。

3.4.2.1. 构造 MouseEvent

通常，当调用 Event 接口或其继承自 Event 接口的构造函数时，应遵循 [DOM] 中描述的步骤。然而 MouseEvent 接口提供了用于初始化 Event 对象键盘修饰符内部状态的额外字典成员，这些状态可通过 getModifierState() 方法查询。本节补充了 DOM4 中初始化新 MouseEvent 对象的相关步骤，以支持这些可选修饰符状态。

在构造 MouseEvent 或使用下述算法从这些对象派生对象时，所有 MouseEvent 及其派生对象都具有可通过 键盘修饰符名称（参见 修饰键列表，[UIEvents-Key]）设置和获取的 内部键修饰符状态。

以下步骤补充了 DOM4 事件构造算法：

• 如果正在构造的 Event 是 MouseEvent 对象或其派生对象，且构造函数传入了 EventModifierInit 参数，则执行以下子步骤：

  • 对每个 EventModifierInit 参数，如果字典成员以 "modifier" 开头，则将字典成员名称去掉前缀 "modifier" 得到 修饰键名称，并将 Event 对象中匹配的 内部键修饰符状态设置为对应值。

3.4.3. MouseEvent 算法

3.4.3.1. 原生操作系统要求

本节的算法假定原生平台操作系统会提供如下能力：

• 鼠标移动时触发事件（由 处理原生鼠标移动 处理）

• 鼠标按钮按下时触发事件（由 处理原生鼠标按下 处理）

• 鼠标按钮释放时触发事件（由 处理原生鼠标释放 处理）

• 识别鼠标按钮按下是否应被解释为“点击”（由 处理原生鼠标点击 处理）

  • 例如通过标志位或单独事件识别

  • 如果单独的“点击”事件被触发，则原生操作系统会在对应的“鼠标释放”事件之后立即触发该事件，中间不会有其他鼠标相关事件

• 识别鼠标点击是否为“双击”（由 处理原生鼠标双击 处理）

对于上述事件，操作系统能提供如下信息：

• 相对于原生操作系统桌面的鼠标 x、y 坐标

• 相对于 UA（用户代理）窗口视口的鼠标 x、y 坐标

• 当前按下了哪些键盘修饰键

3.4.3.2. MouseEvent 全局状态

3.4.3.2.1. 用户代理级状态

UA 必须维护如下全局共享值：

用于追踪鼠标按钮当前状态的 鼠标按钮位掩码。

3.4.3.2.2. 窗口级状态

UA 必须维护如下窗口级共享值：

初始值为未定义的 上次鼠标元素，用于记录最近发送 MouseEvent 的 Element。

初始为空的 上次鼠标 DOM 路径，包含最近一次发送鼠标事件时 上次鼠标元素 的所有祖先 Element 的快照。

3.4.3.3. MouseEvent 内部状态

MouseEvent 有如下内部标志用于追踪各种修饰键状态：shift 标志、control 标志、 alt 标志、altgraph 标志、 meta 标志。 如果对应修饰键在鼠标事件发生时被按下，则这些标志会被设置。

3.5. 滚轮事件

滚轮是一种可以在一个或多个空间维度上旋转的设备，可以与指针设备相关联。坐标系统取决于环境配置。

用户环境可能配置为将垂直滚动与y轴旋转相关联，水平滚动与x轴旋转相关联，缩放与z轴旋转相关联。

WheelEvent 对象的 deltaX、deltaY 和 deltaZ 属性表示沿各自轴的测量值，单位为像素、行或页。实际测量值是经过环境特定算法，将滚轮设备的实际旋转/移动转换为适当的值和单位后得到的。

用户环境设置可以自定义对滚轮设备实际旋转/移动的解释。例如，常见的有齿鼠标滚轮一次滚动可以产生162像素的测量（162只是示例值，实际值取决于用户代理的当前屏幕尺寸）。用户可以更改默认环境设置来加快鼠标滚轮速度，从而增加此数值。此外，部分鼠标滚轮软件支持加速（滚轮旋转越快，每次测量的 delta 越大），甚至支持亚像素旋转测量。因此，作者不能假定在一个用户代理中的某个旋转量会在所有用户代理中产生相同的delta值。

deltaX、deltaY 和 deltaZ 属性的符号（正或负）在多次分发 wheel 事件且实际滚轮设备旋转/移动方向一致时必须保持一致。如果用户代理将滚轮事件的默认行为设为滚动，则delta的符号应遵循右手坐标系：正的X、Y、Z轴分别指向文档的最右边、最下边和最远端（远离用户）。

各个用户代理（视环境和硬件配置而定）可能对同一物理滚轮操作有不同解释。例如，在触控板边缘从上到下进行一次垂直滑动可以被解释为向下滚动页面或向上平移页面（即分别导致正或负的 deltaY 值）。

用户代理在首次触发滚轮事件时，必须创建一次滚轮事件事务，以便在实现定义的时间范围内的所有后续滚轮事件都能定位到同一元素。滚轮事件事务是一系列与单个用户操作相关联的滚轮事件。该滚轮事件事务必须具有与首次滚轮事件发生时的最顶层事件目标相关联的事件目标。

在可滚动元素中定位的一系列滚轮事件可能是从子元素上方开始的，同一次用户操作的后续事件可能会发生在子元素上。

3.5.1. WheelEvent 接口

本规范中引入

WheelEvent 接口提供了与 wheel 事件相关的特定上下文信息。

要创建 WheelEvent 接口实例，请使用 WheelEvent 构造函数，并传递可选的 WheelEventInit 字典参数。

3.5.1.1. WheelEvent

[Exposed=Window]
interface WheelEvent : MouseEvent {
  constructor(DOMString type, optional WheelEventInit eventInitDict = {});
  // DeltaModeCode
  const unsigned long DOM_DELTA_PIXEL = 0x00;
  const unsigned long DOM_DELTA_LINE  = 0x01;
  const unsigned long DOM_DELTA_PAGE  = 0x02;

  readonly attribute double deltaX;
  readonly attribute double deltaY;
  readonly attribute double deltaZ;
  readonly attribute unsigned long deltaMode;
};

DOM_DELTA_PIXEL

delta 的单位必须为像素。这是大多数操作系统和实现配置下最常见的情况。

DOM_DELTA_LINE

delta 的单位必须为文本行。许多表单控件采用此方式。

DOM_DELTA_PAGE

delta 的单位必须为页面，可以定义为单个屏幕或标记的页面。

deltaX, 类型为 double，只读

在默认行为为滚动的用户代理中，值必须为事件未取消时沿x轴滚动的测量值（单位为像素、行或页）。否则，该值为实现特定的滚轮设备围绕x轴移动的测量值（单位为像素、行或页）。

此属性的未初始化值必须为0.0。

deltaY, 类型为 double，只读

在默认行为为滚动的用户代理中，值必须为事件未取消时沿y轴滚动的测量值（单位为像素、行或页）。否则，该值为实现特定的滚轮设备围绕y轴移动的测量值（单位为像素、行或页）。

此属性的未初始化值必须为0.0。

deltaZ, 类型为 double，只读

在默认行为为滚动的用户代理中，值必须为事件未取消时沿z轴滚动的测量值（单位为像素、行或页）。否则，该值为实现特定的滚轮设备围绕z轴移动的测量值（单位为像素、行或页）。

此属性的未初始化值必须为0.0。

deltaMode, 类型为 unsigned long，只读

deltaMode 属性包含 delta 值的单位指示。默认值为 DOM_DELTA_PIXEL（像素）。

此属性必须设置为 DOM_DELTA 常量之一，用于指示 delta 值的单位。具体测量依赖于设备、操作系统和应用配置。

此属性的未初始化值必须为0。

3.5.1.2. WheelEventInit

dictionary WheelEventInit : MouseEventInit {
  double deltaX = 0.0;
  double deltaY = 0.0;
  double deltaZ = 0.0;
  unsigned long deltaMode = 0;
};

deltaX, 类型为 double，默认值为 0.0

参见 deltaZ 属性。

deltaY, 类型为 double，默认值为 0.0

参见 deltaZ 属性。

deltaZ, 类型为 double，默认值为 0.0

初始化 deltaZ 属性。此属性（以及 deltaX、deltaY）的正值采用右手坐标系：X、Y、Z 轴分别指向文档最右、最下和最远（远离用户）。负值则为相反方向。

deltaMode, 类型为 unsigned long，默认值为 0

初始化 deltaMode 属性，枚举值为 0、1 或 2，分别表示滚动的像素量（DOM_DELTA_PIXEL）、行数（DOM_DELTA_LINE）或页数（DOM_DELTA_PAGE），如果滚轮旋转会导致滚动。

3.5.2. 滚轮事件类型

3.5.2.1. wheel

用户代理必须在鼠标滚轮围绕任一轴旋转，或等效输入设备（如鼠标球、某些平板或触控板等）模拟此操作时分发此事件。根据平台和输入设备，斜向滚轮delta可能以单个包含多个非零轴的 wheel 事件形式，或为每个非零轴分别分发多个 wheel事件。

wheel 事件类型的典型默认行为是按指示的数量滚动（或在某些情况下缩放）文档。如果此事件被取消，实现不得滚动或缩放文档（或执行与此事件类型相关的其它实现特定默认行为）。

在某些用户代理或某些输入设备中，滚轮旋转速度会影响delta值，旋转速度越快，delta值越大。

3.5.2.2. 滚轮事件的可取消性

在滚轮事件上调用 preventDefault 可以阻止或中断滚动。为了获得最佳滚动性能，用户代理可能不会等待与滚动相关的每个滚轮事件都处理完毕再判断是否被取消。在这种情况下，用户代理应生成 cancelable 属性为 false 的 wheel 事件，表示无法使用 preventDefault 来阻止或中断滚动。否则 cancelable 将为 true。

特别地，如果用户代理检测到没有非被动监听器，则只应生成不可取消的 wheel 事件。

3.6. 输入事件

输入事件是在 DOM 因用户操作（例如在可编辑区域键盘输入、删除或格式化文本等）直接更新或即将更新时发送的通知。

3.6.1. InputEvent 接口

3.6.1.1. InputEvent

在 DOM Level 3 中引入

[Exposed=Window]
interface InputEvent : UIEvent {
  constructor(DOMString type, optional InputEventInit eventInitDict = {});
  readonly attribute USVString? data;
  readonly attribute boolean isComposing;
  readonly attribute DOMString inputType;
};

data, 类型为 USVString，只读，可为 null

data 保存由输入法生成的字符值。它可以是一个 Unicode 字符或一个非空的 Unicode 字符序列 [Unicode]。字符应按照 Unicode 规范中的 NFC 归一化形式进行归一化，定义见 [UAX15]。 此属性可以包含空字符串。

此属性的未初始化值必须为 null。

isComposing, 类型为 boolean，只读

如果输入事件是在一个组合会话期间发生（即在 compositionstart 事件之后、对应的 compositionend 事件之前），则为 true，否则为 false。

此属性的未初始化值必须为 false。

inputType, 类型为 DOMString，只读

inputType 包含一个字符串，用来标识与事件相关的输入类型。

有效值列表参见 [Input-Events] 规范。

此属性的未初始化值必须为 空字符串 ""。

3.6.1.2. InputEventInit

dictionary InputEventInit : UIEventInit {
  DOMString? data = null;
  boolean isComposing = false;
  DOMString inputType = "";
};

data, 类型为 DOMString，可为 null，默认值为 null

初始化 InputEvent 对象的 data 属性。

isComposing, 类型为 boolean，默认值为 false

初始化 InputEvent 对象的 isComposing 属性。

inputType, 类型为 DOMString，默认值为 ""

初始化 InputEvent 对象的 inputType 属性。

3.6.2. 输入事件顺序

本规范定义的输入事件必须按照特定顺序发生。

3.6.3. 输入事件类型

3.6.3.1. beforeinput

用户代理必须在 DOM 即将更新时分发此事件。

3.6.3.2. input

用户代理必须在 DOM 更新后立即分发此事件。

3.7. 键盘事件

键盘事件是依赖于设备的，即它们依赖于输入设备的能力以及在操作系统中的映射方式。详情请参阅键盘事件和按键值，其中包括键盘事件与组合事件结合使用的示例。根据字符生成设备，可能不会生成键盘事件。

键盘事件只是提供文本输入的一种方式。在编辑场景下，也可以考虑使用 InputEvent 作为键盘事件的替代或补充。

3.7.1. KeyboardEvent 接口

本规范中引入

KeyboardEvent 接口提供与键盘设备相关的特定上下文信息。每个键盘事件都通过一个值引用一个按键。键盘事件通常会发送到拥有焦点的元素。

KeyboardEvent 接口为一些常用修饰键提供了便捷属性：ctrlKey、 shiftKey、 altKey、 metaKey。 这些属性等同于使用 getModifierState() 方法，并分别传入 Control、Shift、Alt 或 Meta。

要创建 KeyboardEvent 接口实例，请使用 KeyboardEvent 构造函数，并传递可选的 KeyboardEventInit 字典参数。

3.7.1.1. KeyboardEvent

[Exposed=Window]
interface KeyboardEvent : UIEvent {
  constructor(DOMString type, optional KeyboardEventInit eventInitDict = {});
  // KeyLocationCode
  const unsigned long DOM_KEY_LOCATION_STANDARD = 0x00;
  const unsigned long DOM_KEY_LOCATION_LEFT = 0x01;
  const unsigned long DOM_KEY_LOCATION_RIGHT = 0x02;
  const unsigned long DOM_KEY_LOCATION_NUMPAD = 0x03;

  readonly attribute DOMString key;
  readonly attribute DOMString code;
  readonly attribute unsigned long location;

  readonly attribute boolean ctrlKey;
  readonly attribute boolean shiftKey;
  readonly attribute boolean altKey;
  readonly attribute boolean metaKey;

  readonly attribute boolean repeat;
  readonly attribute boolean isComposing;

  boolean getModifierState(DOMString keyArg);
};

DOM_KEY_LOCATION_STANDARD

按键激活不能区分为左侧或右侧版本，也不是来自数字小键盘（除了 NumLock 键），也不是来自与数字小键盘对应的虚拟键。

PC 101键美国键盘上的 Q 键。
PC 101键美国键盘上的 NumLock 键。
PC 101键美国键盘主区上的 1 键。

DOM_KEY_LOCATION_LEFT

按键激活来自于左侧按键位置（当该键有多个可能位置时）。

PC 101键美国键盘上的左侧 Control 键。

DOM_KEY_LOCATION_RIGHT

按键激活来自于右侧按键位置（当该键有多个可能位置时）。

PC 101键美国键盘上的右侧 Shift 键。

DOM_KEY_LOCATION_NUMPAD

按键激活来自数字小键盘或与数字小键盘对应的虚拟键（当该键有多个可能位置时）。注意 NumLock 键应始终编码为 location 为 DOM_KEY_LOCATION_STANDARD。

PC 101键美国键盘数字键区上的 1 键。

key, 类型为 DOMString，只读

key 保存与按下的按键对应的key 属性值。

key 属性与传统的 keyCode 属性无关，并且取值集合也不同。

此属性的未初始化值必须为 ""（空字符串）。

code, 类型为 DOMString，只读

code 保存识别被按下物理按键的字符串。该值不受当前键盘布局或修饰键状态的影响，因此某个按键总是返回相同的值。

此属性的未初始化值必须为 ""（空字符串）。

location, 类型为 unsigned long，只读

location 属性表示按键在设备上的逻辑位置。

此属性必须设置为 DOM_KEY_LOCATION 常量之一，以指示设备上的按键位置。

如果用户代理允许按键重映射，则重映射按键的 location 值必须设置为新按键适用的值。例如，如果 "ControlLeft" 键被映射为 "KeyQ" 键， 则 location 属性必须设置为 DOM_KEY_LOCATION_STANDARD。 反之，如果 "KeyQ" 键被重映射到某个 Control 键， 则 location 属性必须设置为 DOM_KEY_LOCATION_LEFT 或 DOM_KEY_LOCATION_RIGHT。

此属性的未初始化值必须为 0。

ctrlKey, 类型为 boolean，只读

如果 Control（控制）修饰键激活，则为 true。

此属性的未初始化值必须为 false。

shiftKey, 类型为 boolean，只读

如果 Shift 修饰键激活，则为 true。

此属性的未初始化值必须为 false。

altKey, 类型为 boolean，只读

如果 Alt（替代/Option）修饰键激活，则为 true。

此属性的未初始化值必须为 false。

metaKey, 类型为 boolean，只读

如果 Meta 修饰键激活，则为 true。

在 Mac 系统上，"Command"（"⌘"）修饰键由该属性表示。

此属性的未初始化值必须为 false。

repeat, 类型为 boolean，只读

当按键被持续按下时为 true。持续按下某键时，必须按照系统配置的速率重复触发 keydown、beforeinput、 input 事件。对于具有长按行为的移动设备，首个 repeat 属性值为 true 的按键事件必须视为长按指示。开始重复所需的按键持续时间取决于配置。

此属性的未初始化值必须为 false。

isComposing, 类型为 boolean，只读

如果按键事件发生在组合会话期间，即在 compositionstart 事件之后、对应的 compositionend 事件之前，则为 true。

此属性的未初始化值必须为 false。

getModifierState(keyArg)

使用按键值查询修饰键状态。

如果是修饰键且处于激活状态则返回 true，否则为 false。

DOMString keyArg

修饰键值。合法的修饰键定义见修饰键表于 [UIEvents-Key]。

如果应用希望区分左右修饰键，可以通过键盘事件和 location 判断。

3.7.1.2. KeyboardEventInit

dictionary KeyboardEventInit : EventModifierInit {
  DOMString key = "";
  DOMString code = "";
  unsigned long location = 0;
  boolean repeat = false;
  boolean isComposing = false;
};

key, 类型为 DOMString，默认值为 ""

初始化 KeyboardEvent 对象的 key 属性为表示按键含义的 Unicode 字符串（考虑所有键盘修饰键，如 shift 状态）。该值为最终有效值。如果按键不是可打印字符，则应为 [UIEvents-Key] 中定义的按键值之一。

code, 类型为 DOMString，默认值为 ""

初始化 KeyboardEvent 对象的 code 属性为表示按下按键的 Unicode 字符串，忽略键盘布局等修饰。该值应为 [UIEvents-Code] 中定义的代码值之一。

location, 类型为 unsigned long，默认值为 0

初始化 KeyboardEvent 对象的 location 属性为如下位置数值常量之一：

• DOM_KEY_LOCATION_STANDARD （数值 0）

• DOM_KEY_LOCATION_LEFT （数值 1）

• DOM_KEY_LOCATION_RIGHT （数值 2）

• DOM_KEY_LOCATION_NUMPAD （数值 3）

repeat, 类型为 boolean，默认值为 false

初始化 KeyboardEvent 对象的 repeat 属性。当前 KeyboardEvent 被认为是由于单个按键长按导致的重复事件序列时应为 true，否则为 false。

isComposing, 类型为 boolean，默认值为 false

初始化 KeyboardEvent 对象的 isComposing 属性。若事件发生在组合序列期间则为 true，否则为 false。

为兼容现有内容，虚拟键盘（如屏幕输入设备上的软件键盘）应生成正常范围的键盘事件，即使它们没有物理按键。

在某些实现或系统配置下，部分按键事件或其值可能会被正在使用的输入法抑制。

3.7.2. 键盘事件按键位置

location 属性可用于区分由键盘上不同物理按键生成的 key 值，例如左右 Shift 键或物理方向键与数字键盘方向键（NumLock 关闭时）。

下表定义了键盘上具有多个位置的特殊按键的有效 location 取值：

对于未在表中列出的所有其它按键，location 属性必须始终设置为 DOM_KEY_LOCATION_STANDARD。

3.7.3. KeyboardEvent 算法

3.7.3.1. KeyboardEvent 的全局状态

3.7.3.1.1. 用户代理级状态

UA 必须维护以下用于整个用户代理的共享值。

一个 按键修饰状态 （初始为空），用于记录系统上每个修饰键的当前状态。

3.7.4. 键盘事件顺序

本规范定义的键盘事件针对任意按键按如下固定顺序发生：

如果按键被持续按下，则以下事件可能会以依赖环境的速率重复：

通常，与某个按键关联的默认行为会在 keyup 事件分发前完成。这可能会使 keyup 事件略有延迟（但一般不可察觉）。

按键事件的事件目标为当前聚焦并处理键盘操作的元素。通常为 HTML input 元素或可编辑文本元素，但也可以是宿主语言定义用于接受键盘输入（如激活快捷键或触发其他行为）的元素。如果没有合适的元素获得焦点，事件目标将为 HTML body 元素（如可用），否则为根元素。

事件目标在不同键盘事件间可能发生变化。例如，keydown 事件针对 Tab 键时，事件目标可能与同一次击键的 keyup 事件不同。

3.7.5. 键盘事件类型

3.7.5.1. keydown

用户代理必须在按下按键时分发此事件。keydown 事件类型依赖设备，取决于输入设备的能力及其在操作系统中的映射。该事件类型必须在按键映射之后生成，并且必须在与同一按键相关的 beforeinput、input 和 keyup 事件之前分发。

keydown 事件的默认行为取决于按键：

• 如果按键与字符关联，默认行为必须是分发一个 beforeinput 事件，紧接着一个 input 事件。如果按键与多个字符关联（如宏或某些死键序列），默认行为必须为每个字符分发一组 beforeinput / input 事件

• 如果按键与文本输入法系统相关联，则默认行为必须是启动该系统

• 如果按键是 Tab 键，默认行为必须是将文档焦点从当前焦点元素（如有）转移到新焦点元素，详见焦点事件类型

• 如果按键是 Enter 或 （空格），且当前焦点在状态变更元素上，默认行为必须是分发一个 click 事件，以及一个 DOMActivate 事件（如用户代理支持该事件类型）。

如果该事件被取消，则相关事件类型不得分发，相关操作也不得执行。

keydown 和 keyup 事件传统上用于检测任意按键，而不仅是那些能产生字符值的按键。

3.7.5.2. keyup

用户代理必须在按键释放时分发此事件。keyup 事件类型依赖设备，取决于输入设备的能力及其在操作系统中的映射。该事件类型必须在按键映射之后生成，并且必须在与同一按键相关的 keydown、beforeinput 和 input 事件之后分发。

keydown 和 keyup 事件传统上用于检测任意按键，而不仅是那些能产生字符值的按键。

3.8. 组合事件

组合事件提供了除键盘事件之外的补充或替代文本输入方式，以支持输入键盘上不常见的字符。例如，组合事件可以用于在标准美式键盘上为字符添加重音符号，构建亚洲多字母语言的字形（通过基础部件或类别），在移动设备键盘上通过组合按键选择词语，或通过语音识别处理器将语音命令转换为文本。有关组合事件与键盘事件结合使用的示例，请参阅 § 4 键盘事件和按键值。

从概念上讲，一个组合会话包括一个 compositionstart 事件、一个或多个 compositionupdate 事件，以及一个 compositionend 事件，在每次会话的每个“阶段”之间，data 属性的值会持续存在。

注意： 当组合会话处于活动状态时，如果输入设备为键盘，则仍会向 DOM 派发键盘事件。详细顺序见 compositionstart 事件说明及 IME 部分。

并非所有 输入法 (IME) 系统或设备都会向 DOM 提供所需数据，因此活动的组合字符串（“候选窗口”或“候选菜单选项”）可能无法通过此接口获得，在这种情况下，选择内容可以用空字符串表示。

3.8.1. CompositionEvent 接口

本规范中引入

CompositionEvent 接口提供了与组合事件相关的具体上下文信息。

要创建 CompositionEvent 接口实例，请使用 CompositionEvent 构造函数，并传递可选的 CompositionEventInit 字典参数。

3.8.1.1. CompositionEvent

[Exposed=Window]
interface CompositionEvent : UIEvent {
  constructor(DOMString type, optional CompositionEventInit eventInitDict = {});
  readonly attribute USVString data;
};

data, 类型为 USVString，只读

data 保存由输入法生成的字符值。它可以是一个 Unicode 字符，也可以是一个非空的 Unicode 字符序列 [Unicode]。字符应按照 Unicode 规范中的 NFC 归一化形式进行归一化，定义见 [UAX15]。此属性可以为空字符串。

此属性的未初始化值必须为 ""（空字符串）。

3.8.1.2. CompositionEventInit

dictionary CompositionEventInit : UIEventInit {
  DOMString data = "";
};

data, 类型为 DOMString，默认值为 ""

初始化 CompositionEvent 对象的 data 属性为 IME 组合生成的字符。

3.8.2. 组合事件顺序

本规范定义的组合事件必须按以下固定顺序发生：

3.8.3. 手写识别系统

以下示例描述了使用手写识别系统（如在笔平板上）组合文本片段“text”时的可能事件顺序，采用组合事件进行建模：

3.8.4. 取消组合事件

如果 keydown 事件被取消，则因该 keydown 事件而产生的任何组合事件不应被分发：

如果初始 compositionstart 事件被取消，则文本组合会话应被终止。无论组合会话是否终止，compositionend 事件都必须发送。

3.8.5. 组合期间的按键事件

在组合会话期间，keydown 和 keyup 事件仍必须被发送，并且这些事件的 isComposing 属性必须为 true。

3.8.6. 组合期间的输入事件

在组合会话期间，compositionupdate 必须在 beforeinput 发送之后，但在 input 事件发送之前分发。

大多数输入法不支持在组合会话期间取消更新。

beforeinput 和 input 事件会与 compositionupdate 事件一同发送，只要组合相关 DOM 被更新。由于 compositionend 事件不会导致 DOM 更新，因此此时不应发送 beforeinput 和 input 事件。