用户界面事件(UI Events)

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实现的一般考虑。例如，在XML名称空间中讨论了 命名空间 URI 的处理。 有关 一致性 的其他信息，请参阅 DOM Level 3 Core 规范 [DOM-Level-3-Core] 。 为了符合本规范， 用户代理 不需要完全符合另一个规范，但它 必须 符合本规范中引用的任何其他规范的特定部分 (例如，一个符合用户界面事件的 用户代理 必须 支持 [WebIDL] 中定义的 DOMString 数据类型，但不需要为了符合用户界面事件支持 [WebIDL] 中定义的每个方法或数据类型)。

本规范为不同的 用户代理 、规范和内容作者定义了几类一致性:

1.2.1. Web 浏览器和其他动态或交互式的 用户代理

一个动态的或交互式的 用户代理 ，在这里被称为 浏览器 (无论是 Web 浏览器， AT ( Accessibility Technolog ，无障碍技术)应用程序， 或其他类似的程序)，要符合用户界面事件规范， 用户代理需要支持:

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

• § 3.1 事件派发和 DOM 事件流 机制

• 本规范中定义的所有接口和事件及其相关方法、属性和语义， 除了标记为 弃用 的接口和事件 (符合要求的用户代理 可以 实现弃用的接口、事件或API以保证向后兼容性， 但这并非符合一致性的必要条件)

• 在 [UIEvents-Key] 和 [UIEvents-Code] 中定义的 key 和 code 值的完整集合(取决于平台可用性)，以及

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

当为 事件类型 定义的(触发事件的)条件得到满足时，符合规范的浏览器 必须 恰当地在给定 EventTarget 上 派发 对应事件。

如果浏览器实现了定义在 § 5 事件类型 中的接口和相关的 事件类型 ， 则它局限性地(specifically)符合用户界面事件规范。

一个符合规范的浏览器 必须 支持脚本、 声明性交互，或者能以本规范描述的方式检测和派发事件， 并且 必须 支持为该 事件类型 定义的 APIs 。

为了向后兼容现有内容，除了满足所有其他一致性标准之外， 符合规范的浏览器还 可以 实现此规范已标记为 弃用 的特性， 但不鼓励这样的实现。

一个符合规范的浏览器也 可以 支持本规范中没有的特性，但它实现了 § 3.1 事件派发和 DOM 事件流 机制、接口、事件或本规范中定义的其他特性，并且 可以 实现适合于该浏览器实现的附加接口和 事件类型 。这些特性可能在未来的规范中标准化。

不符合此规范所有要求实现的部分的浏览器 不得 声明符合用户界面事件规范。 这种符合本规范部分要求的实现 可以 声称符合那些特定部分。

如 Web IDL 规范 [WebIDL] 所述， 一个符合规范的浏览器也 必须 是本规范中 IDL 片段的 符合实现(conforming implementation) 。

1.2.2. 创作工具

如果一个内容创作工具生成的内容基于 事件类型 和 § 3.1 事件派发和 DOM 事件流 模型，并且与本规范中定义的方式一致， 那么它就符合用户界面事件规范。

如果内容创作工具使用了本规范中被标记为 弃用 的特性，那么它生成的内容 不得 声称符合用户界面事件规范。

符合规范的内容创作工具 应当 为内容作者提供一种方法，使其能够在生成的内容文档中使用适用于所有 宿主语言 的所有 事件类型 和接口。

这里的创作工具可以理解为开发工具，内容创作工具理解为 Web 开发工具。本规范中说的内容，作者，创作都 可以 从开发者的角度去理解，参见 作者 。

1.2.3. 内容作者和内容

如果一个内容 作者 创建的内容基于 事件类型 和 § 3.1 事件派发和 DOM 事件流 模型，并且与本规范中定义的方式一致， 那么它就是符合用户界面事件规范的内容。

内容作者 不应 使用本规范中标记 弃用 的特性，而 应当 依靠定义在本规范和其他规范的替换机制(replacement mechanisms)。

符合规范的内容 必须 使用本规范中描述的接口和 事件类型 的语义。

建议内容作者遵循在 无障碍 和 国际化 指南规范中描述的最佳实践。

1.2.4. 规范和宿主语言

如果一个规范或 宿主语言 引用并使用本规范中的 § 3.1 事件派发和 DOM 事件流 机制、接口、事件或 在 [DOM] 中定义的其他特性，并且不会以不兼容的方式扩展这些特性， 那么它就是符合用户界面事件规范的。

如果规范或 宿主语言 引用并使用在 § 5 事件类型 中指定的接口和相关 事件类型 ， 那么它局限性地(specifically)符合用户界面事件规范。 符合本规范的规范 可以 定义适用于其自身的附件接口和 事件类型 ，或者 可以 以，与本规范中的接口和 事件类型 的定义 不矛盾或不冲突的方式，去扩展用户界面事件接口和 事件类型 。

引用用户界面事件的规范或 宿主语言 不应 使用或推荐被本规范标记 弃用 的特性，但 应当 使用或建议改特性指定的替代（如果可用）。

2. 格式规约

本规范遵循 建议的W3C规范惯例 ，并添加了以下补充内容:

• 打印在 键帽 上的键显示为 ↓， = 或 Q 。这用于从用户的角度引用键， 而不考虑生成的 KeyboardEvent 事件中的 key (键) 和 code (键码)。

  键帽是放置在计算机键盘的键开关上的塑料、金属或其他材料的小盖子。 键帽通常用于指示它们所对应的键功能或字母数字字符。 ——英文维基。 这里使用特定格式来表示键冒上的键是为了避免与 KeyboardEvent 接口上定义的 key 属性的值和 code 属性值区分， 除此之外也应该与 KeyboardEvent 和 MouseEvent 接口上定义的 ctrlKey ， shiftKey ， altKey ， metaKey 属性区分。举一个例子，如果键帽为 Ctrl 的左控制键被按下，触发一个 keydown 事件， 那么事件对象的 key 属性值就是 "Control"("Control")， code 属性值就是 "ControlLeft"("ControlLeft")， 而 ctrlKey 的属性值是 true ，但通过 getModifierState() 方法检查按键按下状态时， 需要传递的修饰符键值应该是 "Control"("Control") 而非 ctrlKey 。

• 代表字符的字形(Glyphs)显示为: "𣧂"。

  除了汉字以外，还有很多字形需要使用这种方式表示， 例如在苹果电脑键盘上的 "Command" ("⌘") 键修饰符。

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

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

• 与物理键相关的键代码的名称(即 KeyboardEvent.code 的值)显示为: "ArrowDown" ， "Equal" 或 "KeyQ" 。

此外，本规范中会使用具有特定含义的一些术语。术语 实现(implementation) 适用于指代实现本规范的浏览器、内容创作工具或其他 用户代理 ，而内容作者是指编写脚本或代码的人， 这些脚本或代码利用本规范中描述的接口、方法、属性、 事件和其他功能来制作 Web 应用程序，并且用户是在一个实现中使用这些 Web 应用程序的人。

最后:

这是一条注释。

这是一个例子。

这是一个悬而未决的问题。

这是一个警告。

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

2.1. 非官方的翻译规约

本节不是规范的。

本节为译者自行添加， 不属于 英文规范原档内容， 且本节是对翻译过程中的中文翻译，文本样式以及内容补充说明。

2.1.1. 中文翻译

本文档翻译的 UI Events 规范基于 https://www.w3.org/TR/2022/WD-uievents-20220913/。 翻译工作量巨大，翻译时借助了辅助工具，难免出现错误或遗漏的地方， 请不要把本文档当作规范看待，可以当成英文原文档规范的学习参考。

§ 1.2 一致性 中提到了一些英文大写关键字， 这些关键字都翻译成了中文，翻译参考自 shibei-rfc2119 ，非规范表格如下:

因为中文汉字没有大小写的说法，为了将这些关键字和其它文本做出区分， 会为每个关键字包裹一个 类名为 zh-upper 的样式，将其放大1.1倍，例如 必须 。 其 CSS 代码如下:

在 § 14 术语表 中介绍了很多术语，为了保证术语的准确意义， 这些术语本身仍然使用英文，但是在文档的主要内容部分， 为了保证中文内容的完整性，会将这些术语进行翻译。但是不要担心找不到术语， 因为内容中的中文术语都会链接到 § 14 术语表 对应的英文术语上，例如: 用户代理 。

有些英文组合词语的翻译可能难以理解或者难以翻译， 或者说知道它的英文原词的表述可能更易于理解规范内容想要表达的意思， 本中文文档会使用小括号将英文原词显示出来以便学习理解，例如: 位字段(bit-field)、 基本权利要求(Essential Claim(s)) 等。

有些引用其它规范的，或文档的外部链接的，或者在 References 中说明了的链接不会进行翻译，这些通常都是与前端开发相关规范内容， 例如 stopPropagation()、 [HTML]、 [DOM] 等。

最后，如果有些翻译内容表明了本部分文本不是规范的， 或者说本部分只是解释性的补充，请确定它们不是英文原档， 而是本节定义的内容补充，并且这些补充不一定保证完全正确，只用于帮助理解。

2.1.2. 文本样式

中文是没有空格的，字符和字符之间挨着，通过标点符号将一句话分隔以便理解。 但是英文是由单词组成的，每个单词之间通过空格分隔， 最后再用标点符号进行语义区分。由于英文空格的存在， 在英文内容源码换行时， 会自动将新开行的首个单词和上一行的尾部单词之间的回车符号作为空格渲染， 如果中文文本使用同样的规则，会导致在浏览器渲染的最终结果上， 汉字之间有不可避免的空格，这不符合阅读习惯。 为了保证中文的显示效果没有割裂感， 中文源码内容遵循以下在翻译实践中探寻出的规则:

• 标点符号确认——
  冒号，使用英文冒号 : ，并且后带有一个空格;
  分号，使用英文分号 ; ，并且后带有一个空格;
  逗号，使用中文逗号 ， ，作为语义的默认分隔符号;
  句号，使用中文句号 。 ，作为语义的默认结束符号;
  顿号，使用中文顿号 、 ，作为并列词语的分隔符号;
  引号，使用英文双引号 " ，作为引用词语的包裹符号;
  括号，使用英文括号 () ，作为语义解释的包裹符号;
  破折号，使用双横杠 —— ，作为语义解释的延续符号;
  

• 中文源码内容换行规则: 上述的标点符号中，除了引号外， 其它标点符号均可以作为换行标记符号，但不允许(源码内容) 汉字之间出现换行。所以浏览器渲染出来的实际文档内容，有些逗号， 句号等符号后面会多一个空格，但这不影响中文文本阅读。除此之外， 在可以出现空格的位置也可以换行，见下面一条规则。

• 空格符号的使用: 出现链接，斜体，粗体，代码以及在 § 2.1.1 中文翻译 中描述的关键字等所有特殊样式时， 需要使用空格将这些词语与文本分隔，一个例子如下
  

  我 必须 这样 排列 才符合 § 2.1.2 文本样式 规定的 中文格式 。

• 有些英文内容没必要翻译，这个时候使用原本的英文源码内容， 会出现使用英文逗号，英文单词链接左右没有出现空格的情况， 请确认这并非错误，例如接口定义时的 IDL 伪代码， 事件类型中的可信目标对象等。总之，一切规则是为了阅读时更顺畅， 不影响文档文本的阅读观感。

2.1.3. 内容补充

为了辅助理解，有些地方会使用注释，例子，或者图像进行解释说明。 这其中包括英文原档的注释，例子，和图像。有些地方为了解释的更清楚， 或者翻译上有一些问题，会添加自定义的注释，例子或图像。 为了与原本区分开来，它们不会占用例子和图像的数量， 并且能自定义标题以突出区分，如下

这是一条非规范默认注释。

这是一条非规范自定义标题注释。

这是一个默认标题的非规范例子。

这是一个自定义标题的非规范例子。

这是一个默认标题的非规范图像

这是一个自定义标题的非规范图像

3. DOM 事件结构

本节内容并不是规范的。有关 DOM 事件结构的规范性描述，请参阅 [DOM] 。

3.1. 事件派发和 DOM 事件流

本节简要概述了事件 派发 机制， 并描述了事件如何通过 DOM 树传播。应用程序可以使用 dispatchEvent() 方法派发事件对象，事件对象将根据 DOM 事件流在 DOM 树上传播。

汉化图

原图

事件对象被分派到 事件目标 。 但在开始派发之前，事件对象的 传播路径 必须被首先确定。

传播路径 是事件经过的 当前事件目标 的有序列表。 此传播路径反映了文档树的层次结构。这个有序列表的最后一项是 事件目标 ，紧挨着事件目标的前面的一项是 目标的父亲节点(target’s parent) ，而(不包括事件目标的) 前面的所有项被称为 目标的祖先节点(target’s ancestors) 。

一旦确定了 传播路径 ， 事件对象就会经过一个或多个 事件阶段 。 一般会包含三个事件阶段：捕获阶段 、目标阶段 和 冒泡阶段。 每个事件对象都会像下面描述地那样经历完这些阶段，如果不支持某个阶段， 或者事件对象的传播被停止，则该阶段将被跳过。例如，如果 bubbles 属性被设置为 false ， 事件对象就将跳过冒泡阶段，如果在派发之前调用了 stopPropagation() ，则将跳过所有阶段。

• 捕获阶段(capture phase) : 事件对象通过目标的祖先节点从 Window 传播到目标的父节点。这个阶段也被称为 捕获阶段(capturing phase) 。

• 目标阶段(target phase) : 事件对象到达事件对象的 事件目标 。这个阶段也被称为 目标阶段(at-target phase) 。如果 事件类型 指示事件不会冒泡， 那么事件对象将在该阶段完成后停止(传播)。

  所谓"到达事件对象的事件目标"指的就是事件传播到触发事件的元素节点； 事件类型决定了事件本身(在传播时)会不会冒泡， 除了可以通过查看有关事件的规范定义的事件类型表， 以确定一种事件类型能否冒泡外，实践中最直接的方法是检查事件对象的 bubbles 属性的真假值。

• 冒泡阶段(bubble phase) : 事件对象以(和捕获阶段) 相反的顺序在目标的祖先节点中传播，从目标的父节点开始，传播到 Window 结束。这个阶段也被称为 冒泡阶段(bubbling phase) 。

3.2. 默认行为和可取消事件

用户按下定位设备(通常是鼠标)上的按键后，会立即派发 mousedown 事件。 实现所采取的一个可能的 默认行为 是建立一个状态机(state machine)，以允许用户拖动图像或选择文本。 默认行为 取决于接下来会发生什么——例如，如果用户的定位设备在文本上，则可能会开始文本选择; 如果用户的定位设备在图像上，则可以开始图像拖动操作。 阻止 mousedown 事件的 默认行为 将阻止这些操作的发生。

默认行为 通常在事件派发完成后执行， 但在特殊情况下，也可能在事件派发之前立即执行。

与 <input type="checkbox"> 元素上的 click 事件相关联的默认行为是切换(toggles)该元素的 checked IDL 属性值。如果 click 事件的默认操作被取消， 则该值将恢复到以前的状态。

当一个事件被取消时，与该事件相关联的有条件的(conditional) 默认行为 将被跳过(或者如上所述， 如果 默认行为 在派发之前执行， 则其作用将被撤消)。一个事件对象是否可取消由 cancelable 属性指示。调用 preventDefault() 方法将取消事件对象相关的所有 默认行为 。 defaultPrevented 属性表示事件是否已经被取消(例如，由先前的事件侦听器取消)。如果 DOM 应用程序 本身发起了派发操作，那么 dispatchEvent() 方法的返回值能表示事件对象是否被成功取消。

许多实现还将 事件监听器 的返回值(如值 false )解释为可取消事件的 默认行为 将被被取消 (尽管 window.onerror 的处理程序通过返回 true 来取消)。

3.3. 同步和异步事件

事件可以被同步派发，也可以被异步派发。

同步的事件( 同步事件(sync events) ) 就好像它们在先进先出模型的虚拟队列中，按照事件在时间上的派发顺序进行排序， 这种事时间上的发生顺序基于其他事件、 DOM 中的变化和用户交互。 此虚拟队列中的每个事件都会延迟(派发)，直到上一个事件的传播行为完成或被取消。 某些同步事件是由特定的设备或进程驱动的，例如鼠标按键事件。 这些事件由为该组事件定义的 事件顺序 算法控制，用户代理将按算法定义的顺序派发这些事件。

异步的事件( 异步事件(async events) ) 可以在操作结果完成时进行派发，与其他事件、 DOM 中的其他更改或用户交互无关。

在加载文档的过程中，会解析并执行内联脚本元素。 load 事件在脚本元素处排队，等待被异步派发。然而，因为它是一个异步事件， 所以 load 事件相对于文档加载期间派发的其他同步事件 (例如 [HTML5] 中的 DOMContentLoaded 事件)的顺序是不可保证的。

3.4. 可信事件

用户代理 生成的事件，无论是用户交互的结果， 还是DOM更改的直接结果，都受到 用户代理 的信任， 并拥有用户代理给予的特殊权限(privileges)，而脚本代码通过 createEvent() 方法生成、使用 initEvent() 方法修改、 经过 dispatchEvent() 方法派发的事件不具有这种特殊权限 (即不受 用户代理 的信任)。受信任事件(可信事件)的 isTrusted 属性的值为 true ，而不受信任的事件的 isTrusted 属性值为 false 。

除 click 事件外，大多数不受信任的事件不会触发 默认行为 。 click 事件始终触发 默认行为 ，即使它的 isTrusted 属性为 false (为了向后兼容，保留此行为)。 所有其他不受信任的事件表现地就好像在该事件上调用了 preventDefault() 方法一样。

3.5. 激活触发器和行为

某些 事件目标 (例如链接或按钮元素) 可能具有相关联的 激活行为 (例如跟随链接)，这些行为是实现为了响应 激活触发器 (例如点击链接)而执行的。

HTML 和 SVG 都有一个 <a> 元素，它表示一个链接。 <a> 元素的相关 激活触发器 是 <a> 元素的文本或图像内容上的 click 事件，或者当 <a> 元素聚焦时，激活触发器 也可以是 key 属性值为 "Enter" 键的 keydown 事件。 <a> 元素的激活行为通常是: 在链接是外部链接的情况下， 将窗口的内容更改为链接的新文档的内容，或者在链接是内部链接的情况下， 将当前文档相对于新锚点重新定位。

激活触发器 是一个用户操作或一个事件， 它会向实现指示激活行为应该被启动了。 用户发起的 激活触发器 包括: 在可激活元素上单击鼠标按键，当焦点在可激活元素上时按下 Enter 键，或者即使可激活元素不是焦点，按下可以以某种方式链接到可激活元素的键 ( 热键 或 快捷键 )。基于事件的 激活触发器 可以包括: 基于定时器的，在特定时钟时间或在经过特定时间段之后激活元素的事件、 在完成特定动作之后的进度事件、或许多基于条件或基于状态的其他事件。

3.6. 构造鼠标和键盘事件

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

KeyboardEvent 和 MouseEvent 都继承于 UIEvent 接口， 但是它们的构造函数的可选的，用于初始化事件对象的字典并非直接继承于 UIEventInit 。KeyboardEventInit 和 MouseEventInit 字典都继承于 EventModifierInit ，这个字典定义了很多键盘修饰符属性， 用于表示键盘按键的状态。同时 EventModifierInit 是继承于 UIEventInit 的。

为了使用下面的算法构建 KeyboardEvent 、 MouseEvent 或从这些对象派生的对象，所有 KeyboardEvent 、 MouseEvent 和派生对象都具有 内部键修饰符状态 ， 可以使用 [UIEvents-Key] 规范中， 修饰符键表 中描述的键修饰符名称 来设置和检索该状态。

以下步骤补充了定义在 DOM4 中构建事件时的算法：

• 如果正在构造的 Event 是 KeyboardEvent 或 MouseEvent 对象， 或者是从其中任何一个派生的对象，并且向构造函数提供了 EventModifierInit 参数，则运行以下子步骤:

  • 对于每个 EventModifierInit 参数，如果字典成员以字符串 "modifier" 开头，那么将不包括前缀 "modifier" 的 键修饰符名称 视为字典成员的名称， 并将 Event 对象的 内部键修饰符状态 设置为与 键修饰符名称 相匹配的相应成员属性值。

4. 基本事件接口

[DOM] 中定义的基本事件接口是用户界面事件的基础。 这些基本事件接口 必须 始终在实现中的得到支持:

• Event 接口及其定义在 Event 接口内的常量(constant)、方法(method)和属性(attribute):

  • NONE 常量

  • CAPTURING_PHASE 常量

  • AT_TARGET 常量

  • BUBBLING_PHASE 常量

  • type 属性

  • target 属性

  • currentTarget 属性

  • eventPhase 属性

  • bubbles 属性

  • cancelable 属性

  • composed 属性

  • timeStamp 属性

  • defaultPrevented 属性

  • isTrusted 属性

  • stopPropagation() 方法

  • stopImmediatePropagation() 方法

  • preventDefault() 方法

  • initEvent() 方法

• CustomEvent 接口及其定义在 CustomEvent 接口内的方法(method)和属性(attribute):

  • initCustomEvent() 方法

  • detail 属性

• EventTarget 接口及其定义在 EventTarget 接口内的方法(method):

  • addEventListener() 方法

  • removeEventListener() 方法

  • dispatchEvent() 方法

• EventListener 接口和它的 handleEvent() 方法

• Document 接口的 createEvent() 方法

本规范中定义的事件类型派生自这些基本接口，并且派生自的这些接口的用户事件接口 必须 继承它们的所有属性、方法和常量。

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

汉化图

原图

4.1. 事件类型列表

每个事件 必须 与一个类型相关联，该类型称为 事件类型 ，并被用作事件对象的 type 属性。事件类型 必须 为 DOMString 类型。

依据 DOM 支持的级别，或依据用于显示(例如，屏幕)或交互 (例如，鼠标、键盘、触摸屏或语音)的设备，这些事件类型可以由实现决定和生成。 当在 [XML] 或 [HTML5] 应用程序使用(事件类型)时，这些语言的规范 可以 限制与事件类型相关的语义和范围 (特别是在适合的 事件目标 上)。 请参阅有关定义所用语言的规范文档， 以查找这些限制或查找本文档中未定义的事件类型。

下表提供了本规范中描述的事件类型的信息摘要。

有关本规范中不推荐使用的事件的列表，请参阅本文档末尾的 遗留事件类型 附录。

以下是对上表进行解释的一种方式: load 事件将在该事件的捕获和目标阶段上触发(trigger)附加于 Element 节点的 事件监听器 。此事件不可取消。 如果 load 事件的 事件监听器 附加到除了 Window ， Document ， 或 Element 以外的节点，或者仅附加到冒泡阶段，则不会(在被监听事件目标上)触发此 事件监听器 。

不要将上表解释为最权威的(definitive)事件类型列表。 例如， load 事件也用于其他规范中，例如 XMLHttpRequest 中。类似地， 对于 任何 实现了 EventTarget 接口的对象， 可以调用对象的 dispatchEvent() 方法将不受信任的事件派发给它的侦听器。

与上述事件类型相关联的事件对象包含额外的上下文信息——请参阅 DOM 接口的描述获取更多信息。

5. 事件类型

DOM 事件模型允许 DOM 实现支持多个事件模块。 该模型的设计允许将来添加新的事件模块(可扩展)。本文档没有试图定义所有可能的事件。 为了实现互操作性(interoperability)， DOM 定义了一个用户界面事件模块(包括较低级别的设备独立事件)和一个文档变化事件 (document mutation events)模块。

5.1. 用户界面事件

5.1.1. UIEvent 接口

在 DOM Level 2中引入介绍

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

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

对于新定义的事件，你不必继承 UIEvent 接口，因为它们与用户界面相关。 只有当 UIEventInit 的成员对那些事件有意义时才继承。

5.1.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 。

UIEvent.detail ，只读属性，返回一个数字，当值为非零时， 根据具体的事件类型返回点击次数:
① 对于 click 和 dblclick 事件 ，UIEvent.detail 返回当前点击数;
② 对于 mousedown 和 mouseup 事件 ， UIEvent.detail 是 1 加上当前点击数;
③ 对于其它 UIEvent 事件，UIEvent.detail 一直是 0 。

5.1.1.2. UIEventInit

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

UIEventInit . view

应初始化为全局环境的Window对象，该事件将在这个Window对象中派发。 如果这个事件将被派发到一个元素，view属性应该设置为包含改元素的 ownerDocument 的Window对象。

UIEventInit . detail

此属性的初始化值为数字，取决于应用程序(application-specific)。

5.1.2. 用户界面事件类型

用户界面事件类型列表如下所示。如果事件从用户界面生成， 那么这些些事件使用 UIEvent 接口实现， 否则使用 Event 接口实现，详见每个事件。

5.1.2.1. load

当DOM实现(DOM implementation)完成对资源(如文档)和所有的依赖资源 (如图像，样式表或脚本)的加载后， 用户代理 必须派发这个 load 事件。 如果加载依赖资源的元素(如<link>，<script>) 仍然可以通过DOM访问，那么加载失败的依赖资源 绝对不能 阻止此事件的触发。 派发此事件的事件对象 被要求 至少是在 Document 节点上。

由于遗留的原因，在HTML实现的传播路径(事件流)中， 文档内资源(例如，图像)的 load 事件不包括 Window 。 更多信息请参见[HTML5]。

5.1.2.2. unload

当用户代理从环境中移除资源(如文档)或任何依赖资源(如图像，样式表，脚本)时， 用户代理 必须 派发 unload 事件。 DOM文档在派发 unload 事件后 必须 被卸载(unloaded)。 和 load 事件一样，派发此事件的事件对象 被要求 至少是 Document 节点。

5.1.2.3. abort

当资源的加载被中止时，例如用户在加载仍在进行时取消加载， 用户代理 必须 派发此事件。

5.1.2.4. error

当资源加载失败或已加载但无法根据其语义进行解释时， 例如无效图像、脚本执行错误或格式不正确的XML， 用户代理 必须 派发 error 事件。

5.1.2.5. select

当用户选择某些文本时， 用户代理 必须调度此事件。此事件是在选择发生后发出的。

本规范不提供访问所选文本的上下文信息。在应用此事件的情况下， 宿主语言 应 定义用户 可以 如何选择内容(考虑国际语言惯例)、 在什么时候派发 select 事件以及内容作者 可以 如何访问用户选择的内容的规则。

为了访问用户选择的内容，内容作者将使用 宿主语言 的本地功能， 例如HTML Editing API [Editing] 的 Document.getSelection() 方法。

select 事件可能不适用于所有语言的所有元素。 例如，在 [HTML5] 中， select 事件只能在表单 input 和 textarea 元素上派发。 实现可以在任何被认为合适的上下文中派发 select， 包括表单控件之外的文本选择，或者SVG中的图像或标记选择。

5.2. 焦点事件

该接口及其关联的事件类型和 § 5.2.2 焦点事件顺序 是根据 用户代理可访问性指南2.0 [UAAG20] 中定义的概念和指南设计的，需要特别关注 焦点机制 和 焦点术语表条目 中定义的术语。

5.2.1. FocusEvent 接口

在本规范中引入介绍

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

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

5.2.1.1. FocusEvent

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

FocusEvent . relatedTarget

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

出于嵌套浏览上下文的安全考虑，当进入或退出嵌套上下文时， 相关的 EventTarget 应当 为 null 。

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

5.2.1.2. FocusEventInit

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

FocusEventInit . relatedTarget

应该将 relatedTarget 初始化为失去焦点的元素 (在 focus 或 focusin 事件的情况下)或获得焦点的元素 (在 blur 或 focusout事件的情况下)。

5.2.2. 焦点事件顺序

本规范中定义的焦点事件以相对于另一个焦点事件的固定顺序发生。 以下是焦点在元素之间转移时的典型事件序列(此顺序假设最初没有元素被聚焦):

该规范没有定义焦点事件在与 focus() 或 blur() 等方法交互时的行为。请参阅相关规范，其中为此类行为定义了这些方法。

5.2.3. 文档焦点和焦点上下文

此事件模块包括用于通知文档 焦点 发生变更的事件类型。 有三个不同的焦点上下文与这个讨论相关:

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

• 当浏览器获得焦点后，用户可以在不同的浏览器用户界面字段 (例如，Web站点位置栏、搜索字段等)之间切换(例如，使用tab键) 应用程序焦点上下文 。 这些用户界面字段之一可以是在选项卡中显示的文档。

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

本规范中定义的事件类型专门处理文档焦点(而不是操作系统焦点和应用程序焦点)， 在事件详细信息中标识的 事件目标 必须 只能是文档或窗口中的文档的一部分， 而不能是浏览器或操作系统的一部分， 即使是从一个焦点上下文切换到另一个焦点上下文时也是如此。

通常，文档总是有一个焦点元素(即使它本身就是文档元素)和一个持久的 焦点环 。在焦点上下文之间切换时， 文档的当前焦点元素和焦点环通常保持当前状态。例如， 如果一个文档有三个可聚焦的元素，其中第二个元素是聚焦的， 当用户将操作系统焦点更改为另一个应用程序，然后再更改为浏览器时， 第二个元素仍将在文档中聚焦，而选项卡将把焦点更改为第三个元素。 宿主语言 可以 定义可以接收焦点的特定元素、元素 可以 接收焦点的条件、 可以 改变焦点的方式 以及焦点改变(发生事件)的顺序。例如，在某些情况下， 可以通过将指针移到元素上来获得焦点，而在其他情况下可能需要单击鼠标。 有些元素可能根本无法成为焦点，有些元素可能只能通过特殊方式 (单击元素) 变成可聚焦的元素，但不能通过按下 tab 键聚焦它。 文档 可以 包含多个焦点环。 其他规范 可以 定义比本规范中描述的更复杂的焦点模型，包括允许多个元素具有当前焦点。

5.2.4. 焦点事件类型

下面列出了焦点事件类型。

5.2.4.1. blur

当 事件目标 失去焦点后， 用户代理 必须 派发此事件。在派发此事件之前，元素(失去焦点的事件目标) 必须 被取下焦点。此类型类似于 focusout ，并且会发生冒泡。

5.2.4.2. focus

当 事件目标 接收焦点后， 用户代理， 必须 派发此事件。在派发此事件之前， 必须 将焦点放在元素(接收焦点的事件目标)上。此事件类型类似于 focusin ，并且不会发生冒泡。

5.2.4.3. focusin

当 事件目标 接收焦点后， 用户代理 必须 派发此事件。事件目标 必须 是即将接收焦点的元素。focus 事件 必须 在此事件类型派发前发送。 此事件类型类似于 focus ，并且发生冒泡。

5.2.4.4. focusout

当 事件目标 失去焦点后， 用户代理 必须 派发此事件。事件目标 必须 是即将失去焦点的元素。 blur 事件 必须 在此事件类型派发前发送。 此事件类型类似于 blur ，并且发生冒泡。

5.3. 鼠标事件

5.3.1. MouseEvent 接口

在DOM Level 2中引入介绍，并在本规范修改调整

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

在有嵌套元素的场景下，鼠标事件总是把嵌套最深的元素作为目标。

目标元素的祖先可以利用事件冒泡来获取其派生元素中发生的鼠标事件的通知。

要创建 MouseEvent 接口的实例，请使用 MouseEvent 构造函数， 它接收一个可选的 MouseEventInit 字典作为初始化事件的参数。

当使用 initMouseEvent 初始化 MouseEvent 对象时， (浏览器)实现可以使用客户端坐标 clientX 和 clientY 来计算其他坐标(例如 DOM Level 0 实现公开了目标坐标或其他私有属性， 见于 pageX pageY 等)。

5.3.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, of type long, readonly

screenX， long 类型(4字节整型)，只读

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

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

screenY, of type long, readonly

screenY， long 类型(4字节整型)，只读

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

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

clientX, of type long, readonly

clientX， long 类型(4字节整型)，只读

提供了发生事件的位置在应用程序视口中的水平坐标(而不是可能滚动的页面的坐标)。

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

clientY, of type long, readonly

clientY， long 类型(4字节整型)，只读

提供了发生事件的位置在应用程序视口中的竖直坐标(而不是可能滚动的页面的坐标)。

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

layerX, of type long, readonly

layerX， long 类型(4字节整型)，只读

距离最近的 祖先 元素的水平偏移量，该 祖先 元素是 层叠上下文(stacking context) ，确定位置的盒(positioned box) ， 或者是 绘制层叠上下文(painting a stacking context) 时， 在定位阶段的绘制结果。

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

layerY, of type long, readonly

layerY， long 类型(4字节整型)，只读

距离最近的 祖先 元素的垂直偏移量，该 祖先 元素是 层叠上下文(stacking context) ，确定位置的盒(positioned box) ， 或者是 绘制层叠上下文(painting a stacking context) 时， 在定位阶段的绘制结果。

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

ctrlKey, of type boolean, readonly

ctrlKey， boolean 类型，只读

请参阅 KeyboardEvent 的 ctrlKey 属性。

ctrlKey 属性提供了当触发的鼠标事件发生时， ctrl 键修饰符是否活跃的状态

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

shiftKey, of type boolean, readonly

shiftKey， boolean 类型，只读

请参阅 KeyboardEvent 的 shiftKey 属性。

shiftKey 属性提供了当触发的鼠标事件发生时， ctrl 键修饰符是否活跃的状态

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

altKey, of type boolean, readonly

altKey， boolean 类型，只读

请参阅 KeyboardEvent 的 altKey 属性。

altKey 属性提供了当触发的鼠标事件发生时， ctrl 键修饰符是否活跃的状态

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

metaKey, of type boolean, readonly

metaKey， boolean 类型，只读

请参阅 KeyboardEvent 的 metaKey 属性。

metaKey 属性提供了当触发的鼠标事件发生时， ctrl 键修饰符是否活跃的状态

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

button, of type short, readonly

button， short 类型(2字节整型)，只读

在按下或释放鼠标按钮引起的鼠标事件中， 必须 使用 button 来指示指针设备的哪个按键改变了状态。

button 属性的值 必须 如下所示:

• 0 必须 表示设备的主按键 (一般而言是左按键或单按键设备上的唯一按键，用于激活用户界面控件或选择文本) 或 表示未初始化的值。

• 1 必须 表示设备的辅助(auxiliary)按键 (一般而言是中间按键，并与鼠标滚轮组合)。

• 2 必须 表示设备的次(secondary)按键 (一般而言是右按键，通常用于显示一个上下文菜单)。

• 3 必须 表示设备的X1(后退)按键 (第4按键，常用于浏览器后退按键)。

• 4 必须 表示设备的X2(前进)按键 (第5按键，常用于浏览器前进按键)

一些定位设备提供或模拟更多的按键状态，并且 可以 使用高于 2 或低于 0 的值来表示这样的按键状态。

对于不是由按下/释放鼠标按键引起的事件， button 的值不会更新。 在这些场景中，请注意不要将值 0 解释为左按键的激活状态，而是将其解释为 未初始化值 。

一些与 mousedown 和 mouseup 等事件相关的 默认操作 取决于触发事件的特定鼠标按键。

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

buttons, of type unsigned short, readonly

buttons， unsigned short 类型(无符号2字节整型)，只读

在任何鼠标事件触发期间， 必须 使用 buttons 来指示当前设备正被按下的鼠标按键组合，以位掩码表示。

虽然名称相似，但 buttons 属性和 button 属性的值非常不同。 在 mousedown / mouseup 事件处理程序中， button 的值被认为是有效的，而 buttons 属性反映了任何可信的 MouseEvent 对象(在事件被派发时)的鼠标按键的状态，因此它能表示 "当前没有活动的按键"这一状态(buttons 属性值为 0 时)。

buttons 属性的值 必须 是如下所示 (组成的位掩码):

• 0 必须 表示当前没有按键被激活

  按键激活就是按键处于按下状态，下同理

• 1 必须 表示设备的主按键处于激活状态 (一般而言，设备的主按键是左按键或单按键设备上的唯一按键，用于激活用户界面控件或选择文本)。

• 2 必须 表示次按键(如果存在)处于激活状态 (一般而言，设备的次按键是右按键，通常用于显示一个上下文菜单)。

• 4 必须 表示辅助按键处于激活状态 (一般而言是中间按键，并与鼠标滚轮组合)。

一些定位设备能提供或模拟更多按键。为了表示这些按键，每个连续按钮的值 必须 增长一倍(也就是在二进制序列 8 ， 16 ， 32 ，...)。

因为任何一组按键值的总和(与操作)都是一个唯一的数字， 所以对于一个拥有任意数量的鼠标按键的设备而言， 开发者可以使用逐位(遍历)操作来确定当前被按下的按钮数量， 以及它们是哪些按键。例如，值 3 表示当前同时按下了左按键和右按键，而值 5 表示当前同时按住了左按键和中间按键。

一些与 mousedown 和 mouseup 等事件相关的 默认操作 取决于使用中的特定鼠标按键。

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

relatedTarget, of type EventTarget, readonly, nullable

relatedTarget， EventTarget 类型，只读，可空

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

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

getModifierState(keyArg)

(该方法)在本规范中引入介绍

使用键值查询(键盘按键)修饰符的状态。

如果它(传入的 keyArg )是一个 (键盘) 修饰符键并且对应的按键被激活， 则返回 true ，否则返回 false 。

DOMString keyArg

有关此参数的描述，请参阅 KeyboardEvent 的 getModifierState() 方法。

5.3.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, of type long, defaulting to 0

screenX， long 类型(4字节整型)， 默认值为 0

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

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

screenY, of type long, defaulting to 0

screenX， long 类型(4字节整型)， 默认值为 0

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

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

clientX, of type long, defaulting to 0

clientX， long 类型(4字节整型)， 默认值为 0

将 MouseEvent 对象的 clientX 属性初始化为鼠标指针相对于用户浏览器的客户端窗口(视口)期望的水平位置。

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

clientY, of type long, defaulting to 0

clientY， long 类型(4字节整型)， 默认值为 0

将 MouseEvent 对象的 clientY 属性初始化为鼠标指针相对于用户浏览器的客户端窗口(视口)期望的竖直位置。

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

button, of type short, defaulting to 0

button， short 类型(2字节整型)， 默认值为 0

将 MouseEvent 对象的 button 属性初始化为一个数字，这个数字表示鼠标按键期望的状态。

值 0 用于表示鼠标主按键，值 1 用于表示辅助按键/鼠标中键，值 2 用于表示鼠标右键。大于 2 的数字也是可能的，但在本文档中没有指定规范。

buttons, of type unsigned short, defaulting to 0

buttons， unsigned short 类型(无符号2字节整型)， 默认值为 0

将 MouseEvent 对象的 buttons 属性初始化为一个数字， 该数字表示鼠标的一个 或多个 按键处于激活状态。

buttons 属性是一个位字段(bit-field)。 如果将掩码值 1 和位字段的值(也就是 buttons 属性值)进行与操作结果为 true (或者说是 1 )， 则表示(事件触发时)鼠标左键(主按键)是按下状态。如果将掩码值 4 和位字段的值(也就是 buttons 属性值)进行与操作结果为 true (或者说是 1 )，则表示(事件触发时)鼠标辅助按键 / 中间按键是按下状态。

在JavaScript中，要初始化 buttons 属性， 例如想要设置右键(2)和中键(4)同时被按下的状态，可以将buttons的值分配为:
  { buttons: 2 | 4 }
或者:
  { buttons: 6 }

relatedTarget, of type EventTarget, nullable, defaulting to null

relatedTarget， EventTarget 类型， 默认值为 null

relatedTarget 应该初始化为鼠标指针刚刚离开其边界的元素 (在发生 mouseover 或 mouseenter 事件的情况下) 或鼠标指针正在进入其边界的元素(在发生 mouseout 或 mouseleave 或 focusout 事件的情况下)。对于其他事件，不需要分配此值(并设为默认值 null )。

在生成鼠标事件时，实现 必须 维护 当前的点击次数 。这 必须 是一个非负整数，表示在特定时间内连续点击定位设备按键的次数。 计数重置之后的延迟是取决于环境配置。

这个点击次数使用 UIEvent 定义的 detail 属性保存。

5.3.2. 事件修饰符初始化器

MouseEvent 和 KeyboardEvent 接口共享一组键盘修饰符属性， 并支持检索附加修饰符状态的机制。以下字典使开发者能够初始化 MouseEvent 和 KeyboardEvent 接口的键盘修饰符属性， 以及通过 getModifierState() 查询附加键盘修饰符状态。使用此字典构造事件的步骤在 事件构造函数 部分中进行了定义。

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, of type boolean, defaulting to false

ctrlKey， boolean 类型， 默认值为 false

如果要将 Control 键修饰符视为活动状态， 则将 MouseEvent 或 KeyboardEvent 对象的 ctrlKey 属性初始化为 true，否则为 false 。

当为 true 时，实现还必须初始化事件对象的键修饰符状态， 以便在提供参数 Control 时，对 getModifierState() 或 getModifierState() 的调用必须返回 true 。

shiftKey, of type boolean, defaulting to false

shiftKey， boolean 类型， 默认值为 false

如果要将 Shift 键修饰符视为活动状态， 则将 MouseEvent 或 KeyboardEvent 对象的 shiftKey 属性初始化为 true，否则为 false 。

当为 true 时，实现还必须初始化事件对象的键修饰符状态， 以便在提供参数 Shift 时，对 getModifierState() 或 getModifierState() 的调用必须返回 true 。

altKey, of type boolean, defaulting to false

altKey， boolean 类型， 默认值为 false

如果要将 Alt (可替代)(或 Option )键修饰符视为活动状态， 则将 MouseEvent 或 KeyboardEvent 对象的 altKey 属性初始化为 true，否则为 false 。

当为 true 时，实现还必须初始化事件对象的键修饰符状态， 以便在提供参数 Alt 时，对 getModifierState() 或 getModifierState() 的调用必须返回 true 。

metaKey, of type boolean, defaulting to false

metaKey， boolean 类型， 默认值为 false

如果要将 Meta 键修饰符视为活动状态， 则将 MouseEvent 或 KeyboardEvent 对象的 metaKey 属性初始化为 true，否则为 false 。

当为 true 时，实现还必须初始化事件对象的键修饰符状态， 以便在提供参数 Meta 时，对 getModifierState() 或 getModifierState() 的调用必须返回 true 。

modifierAltGraph, of type boolean, defaulting to false

modifierAltGraph， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 AltGraph 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierCapsLock, of type boolean, defaulting to false

modifierCapsLock， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 CapsLock 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierFn, of type boolean, defaulting to false

modifierFn， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 Fn 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierFnLock, of type boolean, defaulting to false

modifierFnLock， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 FnLock 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierHyper, of type boolean, defaulting to false

modifierHyper， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 Hyper 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierNumLock, of type boolean, defaulting to false

modifierNumLock， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 NumLock 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierScrollLock, of type boolean, defaulting to false

modifierNumLock， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 NumLock 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierSuper, of type boolean, defaulting to false

modifierSuper， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 Super 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierSymbol, of type boolean, defaulting to false

modifierSymbol， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 Symbol 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

modifierSymbolLock, of type boolean, defaulting to false

modifierSymbolLock， boolean 类型， 默认值为 false

初始化事件对象的键修饰符状态，以便在提供 SymbolLock 参数时，调用 getModifierState() 或 getModifierState() 必须返回 true 。

关于修饰符键的表示的具体键盘按键， 在不同的键盘设备和不同的操作系统上，甚至不同的浏览器上， 都会有不同的映射关系以及不同的修饰符键支持程度。 可以参阅 [UIEvents-Key] 中的 修饰符键值表格 获取非标准有效的修饰符键列表。也可以参阅 MDN-KeyboardEvent-getModifierState-modifier_keys_on_gecko 了解火狐浏览器内核支持的修饰符键。

5.3.3. 鼠标事件顺序

本规范中定义的某些鼠标事件 必须 按相对于彼此的固定顺序发生。 下面的内容显示了当定位设备的光标移动到元素上时 必须 发生的事件序列:

当定位设备(的光标)移入元素 A ，然后移入嵌套元素 B ，然后再移出时， 必须 发生以下事件序列:

有时，使用 CSS 可以在视觉上重叠元素。 在以下示例中，标记为 A 、 B 和 C 的三个元素在网页上都具有相同的尺寸和绝对位置。 在DOM中，元素 C 是 B 的子元素，而元素 B 是 A 的子元素:

当定位设备从元素堆叠外部移入标记为 C 的元素，然后再次移出时， 必须 发生以下一系列事件:

mouseover/mouseout 事件只触发一次，而 mouseenter/mouseleave 事件触发三次(每个元素一次)。

以下是在元素上按下和释放与定位设备相关联的按键 (例如，鼠标按键或触控板)时的典型事件序列:

允许在一对 mousedown 和 mouseup 事件触发后，仍然派发 click 或 dblclick 事件(在mousedown 和 mouseup 事件派发过程中)的延迟时间、程度、距离和 mousemove 事件的数量的具体限制或容忍度，将取决于实现、设备和平台。 这种容忍度有助于身体残疾的用户(浏览操作网页)，比如， 有些手不稳的用户与定位设备交互时的场景。

如果 mousedown 事件的事件目标是 HTML 文档的 body 元素，而相应的 mouseup 事件的事件目标是 根元素 ，那么 click 事件将在 根元素 上触发，因为它是最近的公共祖先节点。

如果在鼠标事件序列期间从 DOM 中删除了 事件目标 (例如，目标元素)，则该序列中的其余事件 不得 在该元素上触发。

如果在 mousedown 事件触发的(事件处理程序中)从 DOM 中删除了目标元素， 则不会在该元素上派发 mouseup 、 click 或 dblclick 事件，也不会派发任何默认激活事件。但是，在移除初始目标元素之后， mouseup 事件仍将在暴露给鼠标的元素上被派发。类似地，如果在 mouseup 事件的派发过程中从 DOM 中删除了目标元素，也不会派发 click 和后续事件。

5.3.4. 鼠标事件类型

鼠标事件类型如下所示。在嵌套元素的情况下，鼠标事件类型的事件目标总是嵌套最深的元素。 目标元素的祖先元素 可以 利用冒泡机制来获得在其后代元素发生的鼠标事件的通知。

5.3.4.1. auxclick

当用户按下并释放非主要指针按键(次要按键和辅助按键)时， 或者以模拟这种操作的方式激活指针时， auxclick 事件类型 必须 被派发到指针指示的 最顶层的事件目标 上。 鼠标按键的致动方法取决于指针设备和环境配置，例如，它 可以 取决于屏幕位置或指针设备按键的按下和释放之间的延迟。

auxclick 事件只应被非主要指针按键触发 (即，当 button 不为 0 ，且按钮值大于 1 时) 。主按键 (如标准鼠标上的左键) 不得 触发 auxclick 事件。 请参阅 click 以获取与主按键关联的相应事件。

auxclick 事件触发之前 可以 是同一元素上触发的 mousedown 和 mouseup 事件，而不考虑其他节点类型 (例如文本节点) 之间的更改。 根据环境配置，如果在按下和释放指针设备按键之间发生一个或多个 mouseover 、 mousemove 和 mouseout 事件， 则 可以 会派发 auxclick 事件。

auxclick 事件类型的 默认行为 根据事件的 事件目标 和 button 或 buttons 属性的值而有所不同。 auxclick 事件类型的典型默认操作如下:

• 如果 事件目标 具有相关的 激活行为 ，则 默认操作 必须 是执行该激活行为 (参见 § 3.5 激活触发器和行为 ) 。

接收和处理点击中间按键触发的 auxclick 事件。
myLink.addEventListener("auxclick", function(e) { if (e.button === 1) { // 这将阻止默认行为，例如 // 在链接上单击鼠标中键时打开一个新选项卡。 e.preventDefault(); // 做一些其他事情来处理中间按键的点击， // 比如以适合应用程序的方式打开新选项卡中的链接或非链接按钮。 // 还有其他操作，如应该在点击操作中完成——关闭标签条中的标签， // 也可以在这里完成。 } });

在单击右键的情况下， auxclick 事件是在任何 contextmenu 事件之后派发的。请注意，一些用户代理在显示上下文菜单时会吞下所有输入事件， 因此 auxclick 可能不适用于此类场景中的应用程序。 请参阅 此示例 以获得更多说明。

接收和处理点击右键触发的 auxclick 事件
myDiv.addEventListener("contextmenu", function(e) { // 此调用确保不会显示任何上下文菜单来干扰页面接收事件。 e.preventDefault(); }); myDiv.addEventListener("auxclick", function(e) { if (e.button === 2) { // 做一些其他事情来处理右键点击， // 比如在应用程序中打开自定义的上下文菜单。 } });

5.3.4.2. click

当用户按下并释放主要指针按键时，或者以模拟这种操作的方式激活指针时， click 事件类型必须被派发到指针指示的 最顶层的事件目标 上。 鼠标按键的致动方法取决于指针设备和环境配置，例如，它 可以 取决于屏幕位置或指针设备按键的按下和释放之间的延迟。

click 应仅针对主要指针按键触发 (即，当 button 为 0 ， buttons 为 1 时) 。 辅助按钮 (如标准鼠标上的中键或右键) 不得触发 click 事件。 请参阅 auxclick 以获取与非主要按键关联的相应事件。

click 事件触发之前 可以 是同一元素上触发的 mousedown 和 mouseup 事件，而不考虑其他节点类型 (例如文本节点) 之间的更改。 根据环境配置，如果在按下和释放指针设备按键之间发生一个或多个 mouseover 、 mousemove 和 mouseout 事件， 则 可以 会派发 click 事件。 click 事件之后 可以 还会触发 dblclick 事件。

如果用户在具有较大行高样式的 <p> 元素的子节点——文本节点上按下鼠标按键，稍微移动鼠标(不松开鼠标按键)， 使其不再位于包含文本的区域的上方，但仍然位于该 <p> 元素的包含块内 (即，指针位于同一文本块的行之间，但不位于文本节点本身的上方) ， 然后松开鼠标按键，因为用户一直处于同一元素的领域内，这可能仍然会触发 click 事件 (假设鼠标按键点击和释放的时间间隔落在 click 的正常时间上的 滞后 范围内) 。 请注意，用户代理生成的鼠标事件不会在文本节点上派发。

除了与指针设备关联外， click 事件类型必须 作为元素激活的一部分进行调度，如 § 3.5 激活触发器和行为 所述。

为了最大限度地提高可访问性，鼓励开发者在定义自定义控件的激活行为时使用 click 事件类型，而不是其他更特定于设备的定位设备事件类型，如 mousedown 或 mouseup 。尽管 click 事件类型起源于指针设备(例如鼠标)，但随后的实现增强将其扩展到了该关联之外， 并且可以将其视为用于元素激活的设备独立的事件类型。

click 事件类型的 默认行为 根据事件的 事件目标 和 button 或 buttons 属性的值而有所不同。 click 事件类型的典型默认操作如下:

• 如果 事件目标 具有相关的激活行为，则 默认行为 必须 是执行该激活行为 (参见 § 3.5 激活触发器和行为 ) 。

• 如果 事件目标 是可聚焦的，则 默认行为 必须 是给予该元素文档焦点。

5.3.4.3. contextmenu

用户代理 必须 在调用出上下文菜单之前派发此事件。

当鼠标右键触发 contextmenu 事件时， contextmenu 事件 必须 必须在 mousedown 事件之后被派发。

根据平台的不同， contextmenu 事件可以在 mouseup 事件之前或之后派发。

5.3.4.4. dblclick

当定位设备的主要按键在一个元素上被点击两次时，用户代理 必须 派发这个事件。双击的定义取决于环境配置， 但有一点是确定的: mousedown 、 mouseup 和 dblclick 时间 的事件目标 必须 相同。如果同时触发点击和双击时间， 则此事件类型( dblclick ) 必须 在事件类型 click 之后派发，并且在事件类型 mouseup 之后分派。

与 click 事件一样， dblclick 事件应该仅针对主要指针按键触发。 次要按键 必须 触发 dblclick 事件。

取消(调用 preventDefault() 方法) click 事件不会影响触发 dblclick 事件。

与 click 事件类型一样， dblclick 事件类型的 默认行为 根据事件的 事件目标 和 button 或 buttons 属性的值而变化。通常， dblclick 事件类型的典型 默认行为 与对应的 click 事件类型的行为相匹配。

在一个具有文本内容的 <p> 元素中进行双击操作，双击后触发的 dblclick 事件的默认行为是选中了一个英文单词，随后再次单机，全选了 <p> 元素中的其它可选部分

5.3.4.5. mousedown

当在元素上按下定位设备按键时，用户代理 必须 必须派发此事件。

许多实现使用 mousedown 事件来开始各种上下文相关的 默认行为 。如果取消此事件， 则可以阻止这些 默认行为 。 其中一些默认行为可能包括: 开始一个图像或链接的 拖/放 (drag/drop) 操作， 开始文本选择等。此外，一些实现提供了鼠标驱动的平移功能——当按下鼠标中键时， mousedown 被派发，该功能会被激活。

5.3.4.6. mouseenter

当定位设备移动到元素或其派生元素的边界上时， 用户代理 必须 派发此事件。当元素或其后代元素之一移动到主要定位设备下方时， 用户代理 也 必须 派发此事件。此事件类型类似于 mouseover ，但不同之处在于它不冒泡， 并且当指针设备从一个元素移动到它的一个后代元素的边界上时， 不得 (在原所在元素上)派发它。

此事件类型与CSS :hover伪类 [CSS2] 有相似之处。另请参阅 mouseleave 事件类型。

5.3.4.7. mouseleave

当定位设备移出元素及其所有后代元素的边界时， 用户代理 必须 派发此事件。 当元素或其后代之一移动到不再位于主定位设备下方时，用户代理 也 必须 派发此事件。 此事件类型类似于 mouseout ，但不同之处在于它不冒泡， 并且在定位备离开元素的边界及其所有后代元素的边界之前， 不得 (在原始元素上) 派发它。

此事件类型与CSS :hover伪类 [CSS2] 有相似之处。另请参阅 mouseenter 事件类型。

5.3.4.8. mousemove

当定位设备在元素上移动时， 用户代理 必须 派发此事件。 移动定位设备时移动事件的触发频率取决于具体的实现、设备和平台， 但 应当 为持续的指针设备移动触发多个连续的 mousemove 事件， 而不是为每个鼠标移动的实例触发一个事件。鼓励实现确定触发的最佳频率， 以平衡响应性和性能。

在一些实现环境中，例如浏览器，如果用户开始了拖动操作 (例如，按下鼠标按键) 并且定位设备已经离开了用户代理的边界， 则 mousemove 事件可以继续激发。

此事件以前在 DOM Level 2 Events 中被指定为不可取消， 但已更改为可取消，以反映用户代理之间现有的互操作性。

5.3.4.9. mouseout

当定位设备移出元素的边界时，或者当元素移动到不再位于主定位设备下方时， 用户代理 必须 派发此事件。此事件类型类似于 mouseleave ，但不同之处在于它可以冒泡， 并且当指针设备从一个元素移动到它的一个派生元素的边界上时， 必须 派发它。

另请参见 mouseover 事件类型。

5.3.4.10. mouseover

当定位设备移出元素的边界时，或者当元素移动到不再位于主定位设备下方时， 用户代理 必须 派发此事件。此事件类型类似于 mouseenter ，但不同之处在于它可以冒泡， 并且当指针设备移动到具有同一 事件监听器 实例的事件目标的祖先元素的边界上时， 必须 派发它。

另请参阅 mouseout 事件类型。

5.3.4.11. mouseup

当定位设备按键在元素上释放时，用户代理 必须 派发此事件。

在某些实现环境中，例如浏览器，即使定位设备离开了用户代理的边界， 也可以派发 mouseup 事件，例如， 用户按下鼠标按键开始拖动操作的场景。

5.4. 滚轮事件

• 用户的环境可以被配置为 沿y轴的垂直滚动、 沿x轴的水平滚动 以及 沿z轴的缩放滚动 。

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

WheelEvent 对象的 deltaX 、deltaY 和 deltaZ 属性表示沿其各自轴的测量值，单位为像素、行或页。 (这些属性)报告的测量值是通过特定于环境的算法将滚轮装置的实际 旋转 / 移动 转换为适当的值和单位后提供的。

用户的环境设置可以自定义，从而以不同的方式解释滚轮设备的实际 旋转 / 移动。 普通 有齿轮的 (dented) 鼠标滚轮的一次移动可以产生 162 像素的测量值 ( 162 只是一个示例值，实际值可能取决于用户代理的当前屏幕尺寸)。 但用户可以更改默认环境设置以加快鼠标滚轮的速度，从而增加这个数字。 此外，一些鼠标滚轮软件可以支持加速(滚轮旋转/移动得越快，每次测量的 增量 越大)，甚至可以支持亚像素(sub-pixel) 旋转 测量值。 因此，开发者不能假定在一个用户代理中的给定一个旋转 测量值会在所有用户代理中产生相同的 增量 值。

deltaX 、 deltaY 和 deltaZ 属性的值的符号(正或负)，在实际滚轮装置沿同一方向 旋转 / 移动 时，必须 在多次派发的 wheel 事件中保持一致。如果一个用户代理将滚动作为 wheel 事件的默认行为，那么 delta 的符号应该由右手坐标系给出，其中正 X 、 Y 和 Z 轴分别指向文档的最右边、 最底边和最远深度(远离用户)。

单个用户代理可以(取决于其环境和硬件配置)以不同的方式解释滚轮上的相同物理用户交互。 例如，从上到下在触控板边缘上的垂直滑动可以被解释为轮子动作， 其目的是向下滚动页面或向上移动页面(即，分别产生正或负的 deltaY 值)。

5.4.1. WheelEvent 接口

在本规范中引入介绍

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

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

5.4.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 的测量单位 必须 是页面， (一个单位值)可以定义为单个屏幕，也可以定义为标定页面(demarcated page)。

deltaX, of type double, readonly

deltaX， double 类型(64位双精度浮点数)，只读

在 wheel 事件的默认行为是滚动(scroll)的用户代理中， 该值 必须 是在事件未取消的情况下， 沿 x 轴滚动的测量值(以像素、行或页面为单位)。否则(默认行为并非滚动)， 这是滚轮设备围绕 x 轴的运动时，实现决定的测量值(以像素、行或页为单位)。

该属性的 未初始化值 必须 是 0.0 。

deltaY, of type double, readonly

deltaY， double 类型(64位双精度浮点数)，只读

在 wheel 事件的默认行为是滚动(scroll)的用户代理中， 该值 必须 是在事件未取消的情况下， 沿 y 轴滚动的测量值(以像素、行或页面为单位)。否则(默认行为并非滚动)， 这是滚轮设备围绕 y 轴的运动时，实现决定的测量值(以像素、行或页为单位)

该属性的 未初始化值 必须 是 0.0 。

deltaZ, of type double, readonly

deltaZ， double 类型(64位双精度浮点数)，只读

在 wheel 事件的默认行为是滚动(scroll)的用户代理中， 该值 必须 是在事件未取消的情况下， 沿 z 轴滚动的测量值(以像素、行或页面为单位)。否则(默认行为并非滚动)， 这是滚轮设备围绕 z 轴的运动时，实现决定的测量值(以像素、行或页为单位)

该属性的 未初始化值 必须 是 0.0 。

deltaMode, of type unsigned long, readonly

deltaMode， unsigned long 类型(32位无符号整型)，默认值为 0

deltaMode 属性包含对 delta 值的测量单位的指示。 默认值为 DOM_DELTA_PIXEL (像素)。

此属性 必须 设置为 DOM_DELTA 常量之一， 以指示 delta 值的测量单位。 合适(precise)的测量单位是由设备、操作系统和应用程序配置共同决定的。

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

5.4.1.2. WheelEventInit

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

deltaX, of type double, defaulting to 0.0

deltaX， double 类型(64位双精度浮点数)，默认值为 0.0

查阅下面的 deltaZ 属性。

deltaY, of type double, defaulting to 0.0

deltaY， double 类型(64位双精度浮点数)，默认值为 0.0

查阅下么 deltaZ 属性。

deltaZ, of type double, defaulting to 0.0

deltaZ， double 类型(64位双精度浮点数)，默认值为 0.0

初始化 WheelEvent 对象的 deltaZ 属性。 该属性(以及deltaX和deltaY属性) 的相对正值由右手坐标系给出，其中 X 、 Y 和 Z 轴分别指向文档的最右边、最下边和最远深度(远离用户)， 相对负值在各自相反的方向上。

deltaMode, of type unsigned long, defaulting to 0

deltaMode， unsigned long 类型(32位无符号整型)，默认值为 0

可以将 WheelEvent 对象上的 deltaMode 属性初始化为枚举值 0 、 1 或 2 ，如果滚轮 旋转 会导致滚动，这些值分别表示滚动的像素量 ( DOM_DELTA_PIXEL )、滚动的行数 ( DOM_DELTA_LINE )或滚动的页数 ( DOM_DELTA_PAGE )。

初始化 WheelEvent 对象的 deltaZ 属性。 该属性(以及deltaX和deltaY属性)的相对正值由右手坐标系给出， 意思就是 daltaX/Y/Z 属性的值的正负符号确定和文档位置坐标系相同。 对于鼠标设备而言， 逆时针 滚动鼠标滚轮(向下，向右或向远离用户)时， delta 值为正， 顺时针 滚动鼠标滚轮(向上，向左或靠近用户)时， delta 值为负。

5.4.2. Wheel Event Types

5.4.2.1. wheel

当鼠标滚轮沿着任何轴旋转/滚动时，或当等效输入设备 (如鼠标球、某些平板电脑或触摸板等)模拟了此类动作时， 用户代理 必须 派发 wheel 事件。根据平台和输入设备，对于旋钮的 deltas (diagonal wheel deltas)，(它的事件)交付方式 既 可以 是多个非零轴的 delta 整合入单个 wheel ，又 可以 是为每个非零轴的 delta 触发单独的 wheel 事件。

非零轴向包括 X 轴、 Y 轴和 Z 轴。在 delta 不为 0 时， delta 可以是 X ， Y， Z 三个轴上的增量值， 上述介绍了两种处理旋钮操作产生多个轴方向不同的 deltas 值时的交付方式——既可以整合到一个 wheel ， 使用三个轴对应的 deltaX ， deltaY ， deltaZ 属性指示各种轴增量值; 又可以为三个轴上的增量值派发三个 wheel 事件，只使用各自的 delta 指示对应的属性值。

wheel 事件类型的典型 默认行为 是按(用户代理)指定的数量滚动(或在某些情况下缩放)文档。如果此事件被取消， 则实现 不得 滚动或缩放文档 (或执行与此事件类型相关的任何其他实现决定的的默认行为)。

在一些 用户代理 中，或者在一些输入设备中， 滚轮转动的速度会影响 delta 值，更快的速度会产生更高(/大)的 delta 值。

5.4.2.2. 滚轮事件的可取消性

在一个滚轮事件上调用 preventDefault 可以阻止或中断滚动。 为了获得最大的滚动性能， 用户代理可能不会等待每个与滚动相关联的滚轮事件被处理完毕 (检阅滚轮事件是否被取消)才派发事件。在这种情况下，用户代理应该生成 cancelable 属性为 false 的 wheel 事件， 表明 preventDefault 不能用于阻止或中断滚动。否则 cancelable 属性将为 true 。

特别是，当用户代理发现事件 没有非被动监听器(non-passive listeners) 时，它应该只生成不可取消(uncancelable)的 wheel 事件。

在 [DOM] 中的 EventTarget 接口中介绍了 addEventListener() 方法的第三个参数， 它的字典定义有一个 passive 属性，表示 事件监听器 是否永远不会调用 preventDefault() ，非被动监听器(non-passive listeners)就是 passive 设置为 false (默认值)的 事件监听器 ，它表示事件可被取消; 再理解上面的话，特意设置 passive 属性为 true ，那么实现只会生成不可取消的 wheel 事件。 总结一下就是:
① wheel 的默认监听器就是非被动监听器( passive 默认为 false)，所以一般的用户代理默认情况下允许在 wheel 的事件处理程序中调用 preventDefault() ， 并且可以生效，生成的事件对象的 cancelable 属性值为 true;
② 如果在使用 addEventListener() 给元素节点添加 wheel 的事件处理程序时，特意传入第三个参数且设置其 passive 属性为 true， 那么这个事件的监听器就是被动监听器(passive listener)，符合上述的 没有非被动监听器(non-passive listeners) 时 的情况。 此时用户代理不允许在 wheel 的事件处理程序中调用 preventDefault()，如果调用也不会生效，生成的事件对象的 cancelable 属性值为 false;

scroll 事件类型的事件对象在 DOM2 中原本属于 § 5.1.2 用户界面事件类型 中定义的事件，为了保持事件类型定义的一致性， 它被移出了 § 5.1.2 用户界面事件类型 规范的事件类型中， 而是在 [CSSOM-View] 的 scrolling-events 进行了明确说明，现在属于 Event 接口定义的事件。 scroll 事件在以前的混杂模式下，通常是监听 window 对象以发现页面中相应元素变化，但是目前在标准模式下，对 document 对象以及元素添加 scroll 事件类型的事件监听器是正确的做法，可以通过这些被监听元素的 scrollLeft 和 scrollTop 属性获取垂直与水平滚动的距离。需要注意，scroll 事件是不冒泡，不可取消，同步触发的事件类型，而 wheel 是冒泡的， 取消可控制的，异步触发的事件类型。

5.5. 输入事件

5.5.1. InputEvent 接口

5.5.1.1. InputEvent

在DOM Level 3中引入介绍

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

data, of type DOMString, readonly, nullable

data， DOMString 类型，只读，可空

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

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

isComposing, of type boolean, readonly

isComposing， boolean 类型，只读

如果输入事件作为一个合成会话(composition session)的一部分发生， 该属性值为 true ，也就是说，在一个 compositionstart 事件之后，在对应的 compositionend 事件之前触发。

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

inputType, of type DOMString, readonly

inputType， DOMString 类型，只读

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

有关此属性的有效值列表，参考 [Input-Events] 规范

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

5.5.1.2. InputEventInit

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

data, of type DOMString, nullable, defaulting to null

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

初始化 InputEvent 对象的 data 属性。

isComposing, of type boolean, defaulting to false

isComposing， boolean 类型，默认值为 false

初始化 InputEvent 对象的 isComposing 属性。

inputType, of type DOMString, defaulting to ""

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

初始化 InputEvent 对象的 inputType 属性。

5.5.2. 输入事件顺序

本规范中定义的输入事件 必须 按相对于彼此的固定顺序发生。

5.5.3. 输入事件类型

5.5.3.1. beforeinput

当 DOM 即将更新时， 用户代理 必须派发此事件。

5.5.3.2. input

当DOM被更新后，用户代理必须立即派发此事件

5.6. 键盘事件

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

5.6.1. KeyboardEvent 接口

在本规范中引入介绍:

KeyboardEvent 接口提供具体的和键盘设备相关的上下文信息。 每个键盘事件都是由一个值引用一个按键。键盘事件通常指向具有焦点的元素。

KeyboardEvent 接口为常见的修饰符按键——ctrlKey, shiftKey, altKey, metaKey提供方便使用的属性。这些属性的值可以等价使用 getModifierState() 方法通过传递对应getModifierState() with Control, Shift, Alt, 或 Meta等按键修饰符获取。

为了创建一个KeyboardEvent接口的实例，可以使用KeyboardEvent的构造函数，并传递一个可选的KeyboardEventInit字典。

5.6.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

激活按键(key activation) 不得 区分为按键的左侧或右侧版本，并且( NumLock 键除外) 激活按键不能源自数字键盘(或不能源自与数字键盘对应的虚拟按键)。

一个 PC 101 美国标准键盘上的 Q 键。
一个 PC 101 美国标准键盘上的 NumLock 键。
一个 PC 101 美国标准键盘上，位于键盘主要区域的 1 键。

标准按键位置: 这个位置下的按键不存在左右两个按键 (一般有左右两个的键都有属于修饰键)，且不包括小键盘区域的按键，详情见 [UIEvents-Code] 的 修饰符按键 和 小键盘 。

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 键。

按键位置码代表的四个位置分别称为: 标准按键位置，左侧按键位置， 右侧按键位置，数字板按键位置，关于它们具体包含的按键如下图， 该图例举出了 PC 101 美国键盘上的四个位置的按键所属， 其它标准键盘请参阅 [UIEvents-Code] 的 键盘布局 。

美式标准 "101" 键盘所有按键对应的各自所属 location 值

key, of type DOMString, readonly

key， DOMString 类型，只读

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

key 属性与遗留的 keyCode 属性无关， 并且没有相同的值集。

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

code, of type DOMString, readonly

code， DOMString 类型，只读

code 保存一个字符串，用于标识正在按下的物理键。 该值不受当前键盘布局或修饰键状态的影响， 因此特定物理按键将始终返回相同的值。

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

location, of type unsigned long, readonly

location， unsigned long 类型(32位无符号整型)，只读

location 属性保存上述四个按键位置码(KeyLocationCode) 之一，它指示按键在设备上的逻辑位置。

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

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

该属性的 未初始化值 必须 是 0.

ctrlKey, of type boolean, readonly

ctrlKey， boolean 类型，只读

如果 Control (control)键修饰符处于活动状态，则为 true 。

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

shiftKey, of type boolean, readonly

shiftKey， boolean 类型，只读

如果shift( Shift )键修饰符处于活动状态，则为 true 。

该属性的 未初始化值 必须 是 false.

altKey, of type boolean, readonly

altKey， boolean 类型，只读

如果 Alt (alternative)(或 "Option" )键修饰符处于活动状态， 则为 true 。

该属性的 未初始化值 必须 是 false.

metaKey, of type boolean, readonly

metaKey， boolean 类型，只读

如果meta( Meta )键修饰符处于活动状态，则为 true 。

在Macintosh系统(苹果电脑)上的 "Command" ( "⌘" ) 键修饰符使用此键修饰符表示。

该属性的 未初始化值 必须 是 false.

repeat, of type boolean, readonly

如果按键被持续按下，则为 true 。持续按下一个键 必须 导致事件 keydown ， beforeinput ， input ，按此触发顺序重复(派发)， 重复的速率由系统配置决定。对于具有 长按按键(long-key-press) 行为的移动设备， repeat 属性值为 true 的第一个按键事件 必须 用作 长按按键(long-key-press) 的指示。为了开启重复效果的按键 必须 被按下的时间长度是依赖配置的 (由配置决定)。

Long-key-press行为是一种用户交互行为， 通常指用户在按下键盘上的某个键时，停留的时间超过了一定的阈值， 例如超过0.5秒或者1秒。 这种行为通常被视为用户在积极地与计算机进行交互，而不是简单地按下按键。
在计算机图形学和人机交互领域，long-key-press 行为通常被用于触发一些特定的功能或者操作。例如，在一些文本编辑器中， 当用户在按下某个键超过一定时间后，会出现一个弹出菜单， 显示与该键相关的操作选项。在其他应用程序中， long-key-press行为则可能被用于执行复制、粘贴、撤销等常见操作。
理解long-key-press行为的关键在于理解其背后的意图和行为逻辑。 与简单地按下按键不同，long-key-press 行为通常意味着用户希望执行某些特定的操作， 而这些操作可能是由计算机系统或者应用程序提供的。因此，理解 long-key-press行为的含义和用途可以帮助我们更好地使用计算机和应用程序， 提高我们的生产力和效率。 ——文心一言

该属性的 未初始化值 必须 是 false.

isComposing, of type boolean, readonly

isComposing， boolean 类型，只读

如果按键事件作为合成会话(composition session)的一部分发生，即在 compositionstart 事件之后和相应的 compositionend 事件之前，则为 true ，否则为 false 。

该属性的 未初始化值 必须 是 false.

getModifierState(keyArg)

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

如果它(传入的键值)是修饰键并且修饰键处于激活状态，则返回 true ，否则返回 false 。

DOMString keyArg

修饰符键值。有效的 修饰键 在 [[UIEvents Key]] 中的 修饰符键值表格 中定义。

如果应用程序希望区分左右修饰键，则可以使用键盘事件和 location 来推断此信息。

"修饰按键"，"修饰符按键"，"修饰键"，"修饰符"，这几种不同的说法， 在本规范的翻译中都表示"修饰符按键"，即"Modifier Keys"， 有时候也会使用"modifiers"简化表示。它是计算机键盘上的一种特殊键 (或组合键)，当按下时， 它会临时修改另一个键的正常功能。
常见的修饰键有 Shift ，Alt ， Ctrl 等， 想要了解修饰符按键的功能定义，可以查阅 修饰符按键 ， 想要知晓本方法检查修饰键的状态传入的所有参数，如上述，查阅 修饰符键值表格 。
getModifierState(keyArg) 方法不会区分是左修饰符按键还是右修饰符按键被激活， 这是由传入的参数是修饰符键值(modifier key value)，也就是修饰符 键属性值 决定的，因为它不区分按键的左右。除了通过 location 来区分左右修饰键，还可以直接通过键码值 code 来区分。

5.6.1.2. KeyboardEventInit

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

key, of type DOMString, defaulting to ""

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

将所有键盘修饰符(如shift-state)纳入考虑范围在考虑后，将键盘事件 (KeyboardEvent)对象的 key 属性初始化为表示该键含义的 unicode 字符串。该值是按键的最终有效值。如果键不是可打印字符， 则它应该是 [UIEvents-Key] 中定义的键值之一。

code, of type DOMString, defaulting to ""

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

忽略键盘布局等任何键盘配置变动，将键盘事件(KeyboardEvent) 对象的 code 属性初始化为表示为按下的物理键的 unicode 字符串。此值应该是[UIEvents-Code] 中定义的键码值之一。

键盘事件对象的键值就是接口中定义的 key 属性值， 键盘事件的码值就是接口中定义的 code 属性值， 前者表示按键的含义通常与键入值有关，会因为区域设置有所不同， 后者表示物理按键的编码，用于标识每个独立的物理按键。在翻译过程中， "键值"，"键属性值"，"按键值"都是 key 属性值，即 "key value" ; "码值"，"键码值"，"码属性值"，"键码属性值"都是 code 属性值，即 "code value" 。关于二者的含义以及所表示的值集合，可以参阅 用户界面事件键盘事件 key 属性值 和 用户界面事件键盘事件 code 属性值 。

location, of type unsigned long, defaulting to 0

location， unsigned long 类型(无符号2字节整型)，默认为 0

将键盘事件(KeyboardEvent)对象的 location 属性初始化为以下表示位置的数值常量之一:

• DOM_KEY_LOCATION_STANDARD (数值 0)

• DOM_KEY_LOCATION_LEFT (数值 1)

• DOM_KEY_LOCATION_RIGHT (数值 2)

• DOM_KEY_LOCATION_NUMPAD (数值 3)

repeat, of type boolean, defaulting to false

repeat， boolean 类型，默认值为 false

初始化键盘事件(KeyboardEvent)对象的 repeat 属性。 如果当前键盘事件(KeyboardEvent)被认为是由长时间按下(非规范补充: 见于 reapeat属性自定义注释 ) 任何单个键引起的类似事件的重复序列的一部分，则该属性应设置为 true ，否则为 false 。

isComposing, of type boolean, defaulting to false

isComposing， boolean 类型，默认值为 false

初始化键盘事件(KeyboardEvent)对象的 isComposing 属性。 如果正在构建的事件是作为合成序列的一部分发生的，则该属性应设置为 true ，否则为 false 。

为了与现有内容兼容，虚拟键盘，如基于屏幕的输入设备上的软件键盘， 预计会产生正常范围的键盘事件，即使它们不具有物理键。

在某些实现或系统配置中，某些按键事件或其按键值可能会被使用中的 输入法编辑器(IME) 抑制(suppressed)。

5.6.2. 键盘事件键位置

location 属性可用于消除键盘上不同物理键 (例如，左右 Shift 键或物理箭头键与当 NumLock 关闭时的数字键盘箭头键)生成的 key 值之间的歧义。

下表定义了键盘上具有多余一个位置的特殊键的有效 location 值:

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

5.6.3. 键盘事件顺序

对于任何给定的键，本规范中定义的键盘事件按相对于彼此的固定顺序发生:

如果按键持续按下，以下事件 可以 以环境配置的速率重复发生:

通常，与任何特定键相关联的任何 默认行为 都会在派发 keyup 事件之前完成。这可能会稍微延迟 keyup 事件的派发(尽管该延迟难以感知)。

键事件的 事件目标 是当前的焦点元素， 即正在处理键盘活动的元素。这通常是 HTML input 元素或可编辑的文本元素，但也 可以 是由 宿主语言 定义的元素， 用于接受非文本目的的键盘输入，例如加速按键(accelerator key) 的激活或触发某些其他行为。如果没有合适的焦点元素，则事件目标将是 HTML body元素 (如果可用)，否则为 根元素 。

事件目标 可能在不同的按键事件之间发生变化。 例如，在同一次击键(keystroke)过程中， Tab 键的 keydown 事件可能与的 keyup 事件具有不同的 事件目标 。

5.6.4. 键盘事件类型

5.6.4.1. keydown

当按下某个键盘按键时， 用户代理 必须 派发此事件。 keydown 事件类型是依赖设备的，它依赖输入设备的功能以及它们在操作系统中的映射方式。 此事件类型 必须 在 键映射 之后生成。此事件类型 必须 在与同一个键关联的 beforeinput 、 input 和 keyup 事件之前被派发。

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

• 如果键与一个字符相关联(也就是键值)，则默认行为 必须 是先派发 beforeinput 事件， 然后再派发 input 事件。如果键与多个字符相关(例如与宏(macro) 或某些 死键 序列相关)，则默认行为 必须 是为每个字符分配一组 beforeinput / input 事件

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

• 如果键是 Tab 键，则默认行为 必须 是将文档焦点从当前焦点元素(如果有)转移到新的焦点元素，如 焦点事件类型 中描述的那样

• 如果键是 Enter 或   (空格)键， 并且当前焦点在状态更改(state-changing)元素上，则默认行为 必须 是派发 click 事件， 如果用户代理支持 DOMActivate 事件类型也会派发一个 DOMActivate 事件(请参阅 § 3.5 激活触发器和行为 了解更多详细信息)

如果此事件被取消，则 不得 派发关联的事件类型，并且 不得 执行关联的行为。

keydown 和 keyup 事件传统上与能检测到的任何按键相关联， 而不仅仅是那些产生 字符值 的键。

5.6.4.2. keyup

当按键被释放时，用户代理 必须 派发此事件。 keyup 事件类型是依赖设备的，它依赖输入设备的功能以及它们在操作系统中的映射方式。 此事件类型 必须 在 键映射 之后生成。此事件类型 必须 在 keydown 、 beforeinput 和与同一个键关联的 input 事件之后被派发。

keydown 和 keyup 事件传统上与能检测到的任何按键相关联， 而不仅仅是那些产生 字符值 的键。

5.7. 合成事件

从概念上讲，合成会话(composition session)由一个 compositionstart (合成启动)事件、一个或多个 compositionupdate (合成更新)事件和一个 compositionend (合成结束)事件组成， data 属性的值在每个会话期间保持在该事件链的每个 阶段(stage) 之间。

注意: 当合成会话(composition session)处于活动状态时，如果键盘输入设备能使用合成会话， 则可以将键盘事件分派到 DOM 。请参阅 compositionstart 事件详细信息和 IME 部分 以了解相关事件的触发排序。

并非所有 输入法编辑器 系统或设备都将必要的数据暴露给 DOM ， 因此活动的合成字符串( 阅读窗口(Reading Window) 或 候补选择菜单选项 )可能无法通过该接口(指合成事件 API)使用， 在这种情况下，选择文本 可以 由 空字符串 表示。

5.7.1. CompositionEvent 接口

在本规范中引入介绍

CompositionEvent 接口提供与合成事件(Composition Events) 相关联的特定上下文信息。

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

5.7.1.1. CompositionEvent

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

data, of type DOMString, readonly

data， DOMString 类型，只读

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

该属性的 未初始化值 必须 是 "" (空字符串)。

5.7.1.2. CompositionEventInit

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

data, of type DOMString, defaulting to ""

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

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

5.7.2. 合成事件顺序

本规范中定义的合成事件(Composition Events) 必须 按以下相对于彼此的固定顺序发生: