指针事件

WebIDL[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

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

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

screenY

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

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

clientX

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

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

clientY

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

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

layerX

相对于最近的祖先元素的水平偏移量；该祖先元素是堆叠上下文，是定位的，或在绘制堆叠上下文时在定位阶段进行绘制。

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

layerY

相对于最近的祖先元素的垂直偏移量；该祖先元素是堆叠上下文，是定位的，或在绘制堆叠上下文时在定位阶段进行绘制。

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

ctrlKey

参见 KeyboardEvent 的 ctrlKey 属性。

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

shiftKey

参见 KeyboardEvent 的 shiftKey 属性。

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

altKey

参见 KeyboardEvent 的 altKey 属性。

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

metaKey

参见 KeyboardEvent 的 metaKey 属性。

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

button

在由鼠标按钮按下或释放引起的鼠标事件期间，button MUST 用于指示哪个指针设备按钮发生了状态变化。

button 属性的取值 MUST 如下：

• 0 MUST 表示设备的主按钮（通常为左键，或单按钮设备上的唯一按钮，用于激活用户界面控件或选择文本）或未初始化值。
• 1 MUST 表示辅助按钮（通常为中键，常与鼠标滚轮组合）。
• 2 MUST 表示次按钮（通常为右键，常用于显示上下文菜单）。
• 3 MUST 表示 X1（后退）按钮。
• 4 MUST 表示 X2（前进）按钮。

某些指向设备提供或模拟更多按钮状态，可使用大于 2 或小于 0 的值来表示这些按钮。

注意

对于非由鼠标按钮按下/释放导致的事件，button 的值不会更新。在这些场景中，应注意不要将 0 解释为左键，而应将其视为默认值。

注意

与 mousedown 与 mouseup 等事件相关的某些默认操作，取决于所使用的具体鼠标按钮。

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

buttons

在任何鼠标事件期间，buttons MUST 用于指示当前被按下的鼠标按钮组合，并以位掩码（bitmask）表示。

注意

尽管名称相似，buttons 属性与 button 属性的取值差异很大。button 的值被假定在 mousedown / mouseup 事件处理程序中有效；而 buttons 属性反映任意受信任的 MouseEvent 对象（在其被派发期间）中鼠标按钮的状态，因为它可以表示“当前没有任何按钮处于激活状态”的状态（0）。

buttons 属性的取值 MUST 如下：

• 0 MUST 表示当前没有按钮处于激活状态。
• 1 MUST 表示设备的主按钮（通常为左键，或单按钮设备上的唯一按钮，用于激活用户界面控件或选择文本）。
• 2 MUST 表示次按钮（通常为右键，常用于显示上下文菜单），如果存在。
• 4 MUST 表示辅助按钮（通常为中键，常与鼠标滚轮组合）。

某些指向设备提供或模拟更多按钮。为表示这些按钮，每增加一个后续按钮，其值 MUST 都必须加倍（按二进制序列 8、16、32、...）。

注意

由于任意一组按钮值之和都是唯一的数字，内容作者可以使用按位运算来确定当前按下了多少个按钮以及分别是哪些按钮，且可适用于设备上任意数量的鼠标按钮。例如，值 3 表示左键与右键当前都被按下；值 5 表示左键与中键当前都被按下。

注意

与 mousedown 与 mouseup 等事件相关的某些默认操作，取决于所使用的具体鼠标按钮。

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

relatedTarget

用于根据事件类型，标识与某个 UI 事件相关的次要 EventTarget。

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

getModifierState(keyArg)

使用一个键值来查询某个修饰键的状态。

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

DOMString keyArg

关于此参数的说明，参见 KeyboardEvent 的 getModifierState() 方法。

WebIDLdictionary 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

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

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

screenY

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

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

clientX

将 clientX 属性初始化为所需的、鼠标指针相对于用户浏览器客户端窗口的水平位置。

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

clientY

将 clientY 属性初始化为所需的、鼠标指针相对于用户浏览器客户端窗口的垂直位置。

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

button

将 button 属性初始化为一个数字，用于表示鼠标按钮的期望状态。

注意

值 0 用于表示主鼠标按钮，值 1 用于表示辅助/中键，值 2 用于表示右键。大于 2 的数字也可能出现，但本文档未对此进行规定。

buttons

将 buttons 属性初始化为一个数字，用于表示鼠标按钮中需要被视为激活的一个或多个按钮。

注意

buttons 属性是一个位字段（bit-field）。若对位字段值应用掩码 1 后结果为真，则主鼠标按钮处于按下状态；若应用掩码 2 后结果为真，则右键处于按下状态；若应用掩码 4 后结果为真，则辅助/中键处于按下状态。

在 JavaScript 中，要将 buttons 属性初始化为如同右键（2）与中键（4）同时被按下，可将 buttons 的值赋为以下任一形式：

{ buttons: 2 | 4 }

或：

{ buttons: 6 }

relatedTarget

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

实现 MUST 在生成鼠标事件时维护 当前点击计数。该计数 MUST 是一个非负整数，用于表示在特定时间内指向设备按钮的连续点击次数。计数在何时重置的延迟取决于环境配置。

本节中的算法假设原生平台操作系统将提供以下内容：

• 当鼠标移动时触发的事件（由 处理 原生鼠标移动 处理）
• 当鼠标按钮按下时触发的事件（由 处理 原生鼠标按下 处理）
• 当鼠标按钮释放时触发的事件（由 处理 原生鼠标释放 处理）
• 一种用于识别鼠标按钮按下何时应被解释为“点击”的方式（由 处理原生鼠标点击 处理）
  • 例如，作为一个标志位，或作为一个单独事件
  • 如果触发一个单独的“点击”事件，则原生操作系统将紧接对应的“鼠标释放”事件之后立即触发它，且中间不会插入其他与鼠标相关的事件
• 一种用于识别鼠标单击何时为“双击”的方式（由 处理原生鼠标双击 处理）

对于这些事件，操作系统将能够提供以下信息：

• 相对于原生操作系统桌面的 x,y 鼠标坐标
• 相对于用户代理窗口视口的 x,y 鼠标坐标
• 当前被按住的键盘修饰键

一般而言，当调用 Event 接口的构造函数，或调用继承自 Event 接口的接口构造函数时，应遵循 [DOM] 中描述的步骤。然而，MouseEvent 接口还提供了额外的字典成员，用于初始化 Event 对象的按键修饰符的内部状态：具体来说，即通过 getModifierState() 方法查询的内部状态。本节补充了 [DOM] 中初始化新的 MouseEvent 对象的步骤，以包含这些可选的修饰键状态。

为了构造 MouseEvent，或使用下述算法从这些对象派生的对象，所有 MouseEvent 及其派生对象都具有 内部按键修饰符状态，其可使用 [UIEvents-Key] 中 修饰键表 所描述的 修饰键名称 来进行设置与读取。

以下步骤补充了 [DOM] 中定义的用于构造事件的算法：

• 如果正在构造的 Event 是一个 MouseEvent 对象或其派生对象，并且构造函数提供了一个 EventModifierInit 参数，则运行以下子步骤：
  • 对于每个 EventModifierInit 参数，如果该字典成员以字符串 "modifier" 开头，则令 按键修饰键名称 为该字典成员去除前缀 "modifier" 后的名称，并将 Event 对象中与该 按键修饰键名称 匹配的 内部按键修饰键状态 设置为相应的值。

一个 MouseEvent 具有以下内部标志位，用于跟踪各类修饰键的状态： shift 标志、 control 标志、 alt 标志、 altgraph 标志、 以及 meta 标志。 若对应的修饰键在鼠标事件发生时处于按下状态，则设置这些标志位。

1. 令 pos 为相对于视口的 x,y 坐标
2. 返回 [CSSOM-View] 的 elementFromPoint() 并传入 pos（位于 pos 的最前层 DOM 元素）
   注意

   为考虑 inert 或 disabled 元素，这里应调用 elementsFromPoint() 并拒绝无效元素。

要使用 event、eventType、eventTarget、bubbles 与 cancelable 来 初始化一个 MouseEvent，请运行以下步骤：

1. 使用 event、eventType、eventTarget、 bubbles 与 cancelable 来初始化一个 UIEvent。
2. 将 event.screenX 设为事件发生位置相对于桌面原点的 x 坐标
3. 将 event.screenY 设为事件发生位置相对于桌面原点的 y 坐标
4. 将 event.clientX 设为事件发生位置相对于 视口 原点的 x 坐标
5. 将 event.clientY 设为事件发生位置相对于 视口 原点的 y 坐标
6. 使用 event 来设置鼠标事件修饰符
7. 将 event.button 设为 0
8. 将 event.buttons 设为 鼠标按钮位掩码
9. 使用 event 来初始化 MouseEvent 的 PointerLock 属性
   问题 1

   我们应该为 PointerLock 提供一个钩子，而不是在此处将其硬编码。

1. 令 event 为要更新的 MouseEvent
2. 如果 按键修饰符状态 包含 "Shift"，则设置 event 的 shift 标志，否则取消设置
3. 如果 按键修饰符状态 包含 "Control"，则设置 event 的 control 标志，否则取消设置
4. 如果 按键修饰符状态 包含 "Alt"，则设置 event 的 alt 标志，否则取消设置
5. 如果 按键修饰符状态 包含 "AltGraph"，则设置 event 的 altgraph 标志，否则取消设置
6. 如果 按键修饰符状态 包含 "Meta"，则设置 event 的 meta 标志，否则取消设置
7. 若事件的 shift 标志 已设置，则将 event.shiftKey 设为 true，否则设为 false
8. 若事件的 control 标志 已设置，则将 event.ctrlKey 设为 true，否则设为 false
9. 若事件的 alt 标志 或 altgraph 标志 已设置，则将 event.altKey 设为 true，否则设为 false
10. 若事件的 meta 标志 已设置，则将 event.metaKey 设为 true，否则设为 false

1. 令 eventType 为包含有效 MouseEvent 类型的 DOMString
2. 令 eventTarget 为该事件的 EventTarget
3. 令 bubbles 为 true
4. 令 cancelable 为 true
5. 令 event 为使用 MouseEvent 进行创建事件的结果
6. 使用 event、eventType、eventTarget、bubbles 与 cancelable 来初始化一个 MouseEvent。
7. 返回 event

1. 令 eventType 为包含有效 MouseEvent 类型的 DOMString
2. 令 eventTarget 为该事件的 EventTarget
3. 令 bubbles 为 "false"
4. 令 cancelable 为 "false"
5. 令 event 为使用 MouseEvent 进行创建事件的结果
6. 使用 event、eventType、eventTarget、bubbles 与 cancelable 来初始化一个 MouseEvent。
7. 返回 event

这将返回一个适用于存储到 MouseEvent 的 button 属性中的按钮 ID。

1. 令 mbutton 为用于标识某个鼠标按钮的 ID
2. 如果 mbutton 为主鼠标按钮，则返回 0
3. 如果 mbutton 为辅助（中键）鼠标按钮，则返回 1
4. 如果 mbutton 为次鼠标按钮，则返回 2
5. 如果 mbutton 为 X1（后退）按钮，则返回 3
6. 如果 mbutton 为 X2（前进）按钮，则返回 4

1. 令 event 为要初始化的 MouseEvent
2. 令 native 为原生鼠标事件
   编辑者注

   TODO.

3. 如果 event.type 属于 [ mousedown, mouseup ]，则
   1. 令 mbutton 为从 native 获取的、用于标识被按下的鼠标按钮的 ID
   2. 将 event.button 设为 使用 mbutton 运行 计算 MouseEvent 的 button 属性 的结果

1. 令 native 为原生 mousedown
2. 令 mbutton 为从 native 获取的、用于标识被按下的鼠标按钮的 ID
3. 按以下方式更新 鼠标按钮位掩码：
   1. 如果 mbutton 为主鼠标按钮，则设置 0x01 位
   2. 如果 mbutton 为次鼠标按钮，则设置 0x02 位
   3. 如果 mbutton 为辅助（中键）鼠标按钮，则设置 0x04 位
      注意

      其他按钮可从 0x08 开始添加。

4. 令 target 为使用从 native 获取的相对于视口的坐标来运行 命中测试 的结果
5. 令 event 为使用 "mousedown" 与 target 运行 创建可取消的 MouseEvent 的结果
6. 使用 native 运行 从原生事件设置 MouseEvent 属性
7. 使用 event 运行 可能发送 pointerdown 事件
8. 令 result 为在 target 处对 event 执行 派发 的结果
9. 若 result 为 true 且 target 是一个可聚焦区域且可通过点击聚焦，则
   1. 在 target 处运行聚焦步骤
10. 若 mbutton 为次鼠标按钮，则
    1. 使用 native、target 运行 可能显示上下文菜单

1. 令 native 为原生 mouseup
   注意

   在 mousedown 与 mouseup 之间可能发生其他鼠标事件。

2. 令 mbutton 为从 native 获取的、用于标识被按下的鼠标按钮的 ID
3. 按以下方式更新 鼠标按钮位掩码：
   1. 如果 mbutton 为主鼠标按钮，则清除 0x01 位
   2. 如果 mbutton 为次鼠标按钮，则清除 0x02 位
   3. 如果 mbutton 为辅助（中键）鼠标按钮，则清除 0x04 位
4. 令 target 为使用从 native 获取的相对于视口的坐标来运行 命中测试 的结果
5. 令 event 为使用 "mouseup" 与 target 运行 创建可取消的 MouseEvent 的结果
6. 使用 native 运行 从原生事件设置 MouseEvent 属性
7. 使用 event 运行 可能发送 pointerup 事件
8. 在 target 处对 event 执行 派发

1. 令 native 为原生鼠标点击
   注意

   对于会生成点击的 mouseup，平台应在 处理原生鼠标释放 之后立即调用此算法。

2. 令 target 为使用从 native 获取的相对于视口的坐标来运行 命中测试 的结果
3. 使用 native 与 target 运行 发送点击事件。

1. 令 native 为原生 mousedown
2. 令 target 为该事件的 EventTarget
3. 令 mbutton 为 1（默认主鼠标按钮）
4. 若 native 有效，则
   1. 令 mbutton 为从 native 获取的、用于标识被按下鼠标按钮的 ID
5. 若 mbutton 为主鼠标按钮，则将 eventType 设为 "click"，否则设为 "auxclick"
6. 令 event 为使用 eventType 与 target 运行 创建一个 PointerEvent 的结果
7. 若 native 有效，则
   1. 使用 event、native 运行 从原生事件设置 MouseEvent 属性
   2. 若 event.screenX 不是整数值，则将其舍入。
   3. 若 event.screenY 不是整数值，则将其舍入。
8. 在 target 处对 event 执行 派发
   注意

   关于浏览器使用 PointerEvents 与坐标舍入的信息，见 pointerevents/100。

   编辑者注

   任何“默认操作”都会在派发期间通过触发目标的 激活行为 算法来处理。因此无需在这里处理。 但是，需要验证现有规范是否处理了 disabled/css-pointer-events/inert/...

   注意

   为处理 HTMLelement.click()，请以 native = null 且 target = HTMLelement 调用此算法。

   注意

   为处理由键盘发起的点击，请以 native = null 且 target = 当前聚焦元素 调用此算法。

1. 令 native 为原生鼠标双击
   注意

   对于会生成双击的鼠标点击，本算法应在处理原生鼠标点击之后立即被调用。

2. 令 mbutton 为从 native 获取的、用于标识被按下鼠标按钮的 ID
3. 若 mbutton 不是主鼠标按钮，则返回
4. 令 target 为使用从 native 获取的相对于视口的坐标来运行 命中测试 的结果
5. 令 event 为使用 "dblclick" 与 target 运行 创建一个 PointerEvent 的结果
6. 使用 event、native 运行 从原生事件设置 MouseEvent 属性
7. 若 event.screenX 不是整数值，则将其舍入。
8. 若 event.screenY 不是整数值，则将其舍入。
9. 在 target 处对 event 执行 派发

1. 令 native 为原生鼠标移动
   问题 2

   该算法对 PointerEvents 的派发做出了一些假设，因为目前尚未明确规定。一旦 pointerevents/285 得到解决，这里可能需要更新。

2. 令 target 为使用从 native 获取的相对于视口的坐标来运行 命中测试 的结果
3. 令 targetDomPath 为 target 的 包含自身的祖先
4. 为离开当前元素生成事件：
   1. 如果 上一个鼠标元素 已定义且不等于 target，则
      1. 令 mouseout 为使用 "mouseout" 与 上一个鼠标元素 运行 创建可取消的 MouseEvent 的结果
         编辑者注

         TODO：从 native 设置 mouseout 属性。+CSSOM 属性。

   2. 使用 mouseout 运行 可能发送 pointerout 事件
   3. 在 target 处对 mouseout 执行 派发
      注意

      需要验证被取消时的行为（看起来没有效果）。

   4. 令 leaveElements 为从 上一个 鼠标 DOM 路径 复制得到的列表，并移除所有与 targetDomPath 共有的元素。
   5. 对 leaveElements 中的每个 element，执行：
      编辑者注

      处理 element 已被删除的情况。 也处理其已被移动的情况：DOM 变更是否应触发 mouseleave 事件？ 我们现在是否应发送？还是应丢弃？ 需要验证当前浏览器的行为。

      1. 令 mouseleave 为使用 "mouseleave" 与 element 运行 创建不可取消的 MouseEvent 的结果
      2. 设置 mouseleave.Event.composed = false
         注意

         检查兼容性：event.composed 的值。规范中为 false。Chrome/Linux = true。Firefox/Linux = false。

      3. 使用 mouseleave 运行 可能发送 pointerleave 事件
      4. 令 result 为在 element 处对 mouseleave 执行 派发 的结果
5. 为进入新元素生成事件：
   1. 如果 target 不是 上一个鼠标元素，则
      1. 令 mouseover 为使用 "mouseover" 与 target 运行 创建可取消的 MouseEvent 的结果
         编辑者注

         TODO：从 native 设置 mouseout 属性。+CSSOM 属性。

      2. 使用 mouseover 运行 可能发送 pointerover 事件
      3. 在 target 处对 mouseout 执行 派发
         注意

         需要验证被取消时的行为（看起来没有效果）。

      4. 令 enterElements 为从 targetDomPath 复制得到的列表，并移除所有与 上一个鼠标 DOM 路径 共有的元素。
      5. 对 enterElements 中的每个 element，执行：
         注意

         处理 element 已被删除或移动的情况。

         1. 令 mouseenter 为使用 "mouseenter" 与 element 运行 创建不可取消的 MouseEvent 的结果
         2. 设置 mouseenter.Event.composed = false
            注意

            检查兼容性：event.composed 的值。规范中为 false。 Chrome/Linux = true。 Firefox/Linux = false。

         3. 使用 mouseenter 运行 可能发送 pointerenter 事件
            注意

            检查 shadow DOM 元素的兼容性。Chrome/Linux 会在该元素与 shadow root 上触发此事件。

         4. 令 result 为在 element 处对 mouseenter 执行 派发 的结果
      6. 将 上一个鼠标元素 设为 target
      7. 将 上一个鼠标 DOM 路径 设为 targetDomPath
6. 令 mousemove 为使用 "mousemove" 与 element 运行 创建可取消的 MouseEvent 的结果
7. 设置 mousemove 的 PointerLock 属性
8. 使用 mousemove 运行 可能发送 pointermove 事件
9. 在 element 处对 mousemove 执行 派发

1. 令 native 为原生 mousedown 或 pointer 事件
2. 令 target 为该事件的 EventTarget
   1. 令 menuevent 为使用 "contextmenu" 与 target 运行 创建一个 PointerEvent 的结果
   2. 若 native 有效，则
      1. 使用 native 运行 从原生事件设置 MouseEvent 属性
   3. 令 result 为在 target 处对 menuevent 执行 派发 的结果
   4. 若 result 为 true，则显示用户代理上下文菜单

当用户按下并释放非主指针按钮，或以其他方式激活指针以模拟此动作时，auxclick 事件类型 MUST 被派发到由指针所指示的 最顶层 事件目标 上。鼠标按钮的触发方式取决于指针设备与环境配置，例如，它 MAY 取决于屏幕位置或指向设备按钮按下与释放之间的延迟。

auxclick 事件应仅对非主指针按钮触发 （即当 button 值不为 0， buttons 值大于 1 时）。主按钮 （例如标准鼠标的左键）MUST NOT 触发 auxclick 事件。对应主按钮的事件参见 click。

auxclick 事件 MAY 之前会在同一元素上触发 mousedown 与 mouseup 事件（忽略其他节点类型之间的变化，例如文本节点）。 取决于环境配置，当按下与释放指向设备按钮之间发生一个或多个事件类型 mouseover、 mousemove 与 mouseout 时， auxclick 事件 MAY 被派发。

auxclick 事件类型的 默认动作 会根据事件的 目标 以及 button 或 buttons 属性的值而变化。auxclick 事件类型的典型默认动作如下：

• 如果该 目标 具有关联的激活行为，则 默认 动作 MUST 为执行该激活行为。

myLink.addEventListener("auxclick", function(e) {
  if (e.button === 1) {
    // This would prevent the default behavior which is for example
    // opening a new tab when middle clicking on a link.
    e.preventDefault();
    // Do something else to handle middle button click like taking
    // care of opening link or non-link buttons in new tabs in a way
    // that fits the app. Other actions like closing a tab in a tab-strip
    // which should be done on the click action can be done here too.
  }
});

myDiv.addEventListener("contextmenu", function(e) {
  // This call makes sure no context menu is shown
  // to interfere with page receiving the events.
  e.preventDefault();
});
myDiv.addEventListener("auxclick", function(e) {
  if (e.button === 2) {
    // Do something else to handle right button click like opening a
    // customized context menu inside the app.
  }
});

当用户按下并释放主指针按钮，或以其他方式激活指针以模拟此动作时，click 事件类型 MUST 被派发到由指针所指示的 最顶层 事件目标 上。鼠标按钮的触发方式取决于指针设备与环境配置，例如，它 MAY 取决于屏幕位置或指向设备按钮按下与释放之间的延迟。

click 事件应仅对主指针按钮触发 （即当 button 值为 0， buttons 值为 1 时）。 次要按钮 （例如标准鼠标的中键或右键）MUST NOT 触发 click 事件。对应非主按钮的事件参见 auxclick。

click 事件 MAY 之前会在同一元素上触发 mousedown 与 mouseup 事件（忽略其他节点类型之间的变化，例如文本节点）。 取决于环境配置，当按下与释放指向设备按钮之间发生一个或多个事件类型 mouseover、 mousemove 与 mouseout 时， click 事件 MAY 被派发。click 事件 MAY 也可能随后触发 dblclick 事件。

如果用户在某个 <p> 元素的一个文本节点子节点上按下鼠标（该 <p> 元素被设置了很大的 line-height），然后稍微移动鼠标，使其不再位于包含文本的区域上方，但仍处于该 <p> 元素的包含块之内（即指针位于同一文本块的两行之间，但本身并未悬停在文本节点之上），随后释放鼠标，则这很可能仍会触发一个 click 事件（如果它落在 click 的正常时间性滞后范围内），因为用户仍在同一元素的范围内。注意，由用户代理生成的鼠标事件不会派发到文本节点上。

除了与指针设备关联之外， click 事件类型 MUST 也必须作为元素激活的一部分被派发。

click 事件类型的 默认动作 会根据事件的 目标 以及 button 或 buttons 属性的值而变化。click 事件类型的典型默认动作如下：

• 如果该 目标 具有关联的激活行为，则 默认 动作 MUST 为执行该激活行为。
• 如果该 目标 可聚焦，则 默认 动作 MUST 为使该元素获得文档焦点。

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

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

当用户在某个元素上方用指向设备的主按钮点击两次时，用户代理 MUST 派发此事件。双击的定义取决于环境配置，但要求在 mousedown、mouseup 与 dblclick 之间，事件目标 MUST 相同。 如果点击与双击同时发生，则此事件类型 MUST 在 click 事件类型之后派发；否则在 mouseup 事件类型之后派发。

与 click 事件一样，dblclick 事件应仅对主指针按钮触发。次要按钮 MUST NOT 触发 dblclick 事件。

在多指针（例如多点触控）场景中，isPrimary 属性用于在每种指针类型的活动指针集合中识别一个主控指针。

• 在任何给定时刻，每种指针类型最多只能有一个主指针。
• 对某一特定指针类型，最先变为活动状态的指针（例如在多点触控交互中第一个触碰屏幕的手指）会成为该指针类型的主指针。
• 只有主指针才会产生兼容鼠标事件。当存在多个主指针时，这些指针都会产生兼容鼠标事件。

“以名称 e 触发一个指针事件”是指：使用 PointerEvent 来触发名为 e 的事件，其属性按 PointerEvent 接口以及 属性与默认动作中的定义进行设置。

如果该事件不是 gotpointercapture、lostpointercapture、click、 auxclick 或 contextmenu 事件，则对该 PointerEvent 运行处理待定指针捕获步骤。

确定目标（即事件将触发于其上的目标）如下：

• 如果已为该指针设置了指针捕获目标覆盖，则将目标设为该指针捕获目标覆盖对象。
• 否则，将目标设为命中测试返回的对象。

令 targetDocument 为目标的节点文档 [DOM]。

如果事件为 pointerdown、pointermove 或 pointerup，则将该事件的 活动文档 （对应该事件的 pointerId）设置为 targetDocument。

如果事件为 pointerdown，关联设备为直接操控设备，并且目标为 Element， 则按隐式指针捕获中的描述，为该 pointerId设置指针捕获到目标元素。

在触发该事件之前，为了确保事件顺序 [UIEVENTS]，用户代理 SHOULD 将目标视为指向设备已从 previousTarget 移动到其上。若设置了 needsOverEvent 标志，则即使目标元素相同，也仍需要一个 pointerover 事件。

将事件触发到已确定的目标上。

将已确定的目标保存为该指针的 previousTarget， 并将 needsOverEvent 标志重置为 false。 如果某个时刻 previousTarget 将不再连接 [DOM]， 则将 previousTarget 更新为沿与向 previousTarget 派发事件相对应的事件路径中，最近的仍连接 [DOM] 的父节点， 并将 needsOverEvent 标志设为 true。

相对于屏幕表面移动的指向设备，或其任一属性发生变化的指向设备，会按 指针事件类型中定义触发各类事件。对于静止的指向设备（既未相对屏幕表面移动，也未发生任何属性变化），若布局变化影响了该指针的 命中测试目标，则 用户代理 MUST 在布局变化后触发某些边界事件；详见 pointerover、pointerenter、pointerout 与 pointerleave。出于性能原因（例如避免过多命中测试或边界事件监听器引发的布局变化），用户代理 MAY 延迟触发这些边界事件。

Pointer Events 提供了两组互补属性，用于表达换能器相对于 X-Y 平面的朝向：tiltX / tiltY（在原始 Pointer Events 规范中引入）以及 azimuthAngle / altitudeAngle（采自 Touch Events - Level 2 规范）。

取决于具体硬件与平台，用户代理很可能只会获得换能器相对于屏幕平面的其中一组朝向值——要么是 tiltX / tiltY，要么是 altitudeAngle / azimuthAngle。用户代理 MUST 使用以下算法来转换这些值。

当用户代理从 azimuthAngle / altitudeAngle 计算出 tiltX / tiltY 时，它 SHOULD 使用 Math.round [ECMASCRIPT] 规则对最终整数值进行舍入。

/* Converting between tiltX/tiltY and altitudeAngle/azimuthAngle */

function spherical2tilt(altitudeAngle, azimuthAngle) {
  const radToDeg = 180/Math.PI;

  let tiltXrad = 0;
  let tiltYrad = 0;

  if (altitudeAngle == 0) {
    // the pen is in the X-Y plane
    if (azimuthAngle == 0 || azimuthAngle == 2*Math.PI) {
      // pen is on positive X axis
      tiltXrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI/2) {
      // pen is on positive Y axis
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI) {
      // pen is on negative X axis
      tiltXrad = -Math.PI/2;
    }
    if (azimuthAngle == 3*Math.PI/2) {
      // pen is on negative Y axis
      tiltYrad = -Math.PI/2;
    }
    if (azimuthAngle>0 && azimuthAngle<Math.PI/2) {
      tiltXrad = Math.PI/2;
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle>Math.PI/2 && azimuthAngle<Math.PI) {
      tiltXrad = -Math.PI/2;
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle>Math.PI && azimuthAngle<3*Math.PI/2) {
      tiltXrad = -Math.PI/2;
      tiltYrad = -Math.PI/2;
    }
    if (azimuthAngle>3*Math.PI/2 && azimuthAngle<2*Math.PI) {
      tiltXrad = Math.PI/2;
      tiltYrad = -Math.PI/2;
    }
  }

  if (altitudeAngle != 0) {
    const tanAlt = Math.tan(altitudeAngle);

    tiltXrad = Math.atan(Math.cos(azimuthAngle) / tanAlt);
    tiltYrad = Math.atan(Math.sin(azimuthAngle) / tanAlt);
  }

  return {"tiltX":tiltXrad*radToDeg, "tiltY":tiltYrad*radToDeg};
}

function tilt2spherical(tiltX, tiltY) {
  const tiltXrad = tiltX * Math.PI/180;
  const tiltYrad = tiltY * Math.PI/180;

  // calculate azimuth angle
  let azimuthAngle = 0;

  if (tiltX == 0) {
    if (tiltY > 0) {
      azimuthAngle = Math.PI/2;
    }
    else if (tiltY < 0) {
      azimuthAngle = 3*Math.PI/2;
    }
  } else if (tiltY == 0) {
    if (tiltX < 0) {
      azimuthAngle = Math.PI;
    }
  } else if (Math.abs(tiltX) == 90 || Math.abs(tiltY) == 90) {
    // not enough information to calculate azimuth
    azimuthAngle = 0;
  } else {
    // Non-boundary case: neither tiltX nor tiltY is equal to 0 or +-90
    const tanX = Math.tan(tiltXrad);
    const tanY = Math.tan(tiltYrad);

    azimuthAngle = Math.atan2(tanY, tanX);
    if (azimuthAngle < 0) {
      azimuthAngle += 2*Math.PI;
    }
  }

  // calculate altitude angle
  let altitudeAngle = 0;

  if (Math.abs(tiltX) == 90 || Math.abs(tiltY) == 90) {
      altitudeAngle = 0
  } else if (tiltX == 0) {
    altitudeAngle = Math.PI/2 - Math.abs(tiltYrad);
  } else if (tiltY == 0) {
    altitudeAngle = Math.PI/2 - Math.abs(tiltXrad);
  } else {
    // Non-boundary case: neither tiltX nor tiltY is equal to 0 or +-90
    altitudeAngle =  Math.atan(1.0/Math.sqrt(Math.pow(Math.tan(tiltXrad),2) + Math.pow(Math.tan(tiltYrad),2)));
  }

  return {"altitudeAngle":altitudeAngle, "azimuthAngle":azimuthAngle};
}

要使用 event、eventType、eventTarget、bubbles 与 cancelable 来 初始化一个 PointerEvent，请运行以下步骤：

1. 使用 event、eventType、eventTarget、bubbles 与 cancelable 来初始化一个 MouseEvent
2. 将所有其他属性初始化为默认的 PointerEvent 值。

要使用 eventType、eventTarget、bubbles 与 cancelable 来 创建一个 PointerEvent，请运行以下步骤：

1. 令 event 为使用 PointerEvent 创建一个事件的结果
2. 使用 event、eventType、eventTarget、bubbles 与 cancelable 来初始化一个 PointerEvent
3. 返回 event

1. 令 eventType 为包含该事件类型的 DOMString
2. 令 mouseevent 为相应的 MouseEvent
3. 令 event 为使用 PointerEvent 创建一个事件的结果
4. 令 target 为 mouseevent.target
5. 使用 event、eventType 与 target 来初始化一个 PointerEvent
6. 将 MouseEvent 的属性从 mouseevent 复制到 event
7. 返回 event

1. 令 mouseout 为相应的 mouseout MouseEvent
2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
   编者注

   这是否可以发送 pointermove 与 pointerrawupdate？还是我们需要 2 个方法？

   编者注

   为了正确定义 pointermove 事件如何被合并，需要什么？

2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
   注意

   与 mousedown 事件不同，按下多个按钮时 pointerdown 事件不会嵌套触发。 传入 MouseEvent 是为了将其字段复制到 PointerEvent 中。

2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
2. 令 target 为 mouseout.target
3. 在 target 处派发 pointerout

1. 令 mouseout 为相应的 mouseout MouseEvent
   注意

   与 mouseup 事件不同，按下多个按钮时 pointerup 事件不会嵌套触发。 传入 MouseEvent 是为了将其字段复制到 PointerEvent 中。

2. 令 pointerout 为使用 "pointerout" 与 mouseout 从 MouseEvent 创建 PointerEvent 的结果
3. 设置 pointerevent 属性
   编者注

   TODO.

4. 令 target 为 mouseout.target
5. 在 target 处派发 pointerout

用户代理 MUST 在发生以下任一情况时，触发一个指针事件，其名称为 pointerover：

• 为指针确定目标的步骤检测到指针已移动进入某个元素。
• 布局变化导致某个元素的 命中测试边界移动到了一个静止指向设备的未捕获指针之下。
• 在用户代理为不支持悬停的设备触发 pointerdown 事件之前（参见 pointerdown）。

用户代理 MUST 在发生以下任一情况时，触发一个指针事件，其名称为 pointerenter：

• 为指针确定目标的步骤检测到指针已移动进入某个元素或其任一后代元素。
• 布局变化导致某个元素或其任一后代元素的 命中测试边界移动到了一个静止指向设备的未捕获指针之下。
• 在用户代理为不支持悬停的设备触发 pointerdown 事件之前（参见 pointerdown）。

用户代理 MUST 当指针进入活动按钮状态时，触发一个指针事件，其名称为 pointerdown。对鼠标而言，即设备从没有任何按钮按下转换为至少有一个按钮按下时。对触摸而言，即与数字化仪发生物理接触时。对笔而言，即笔在没有任何按钮按下的情况下与数字化仪发生物理接触，或在悬停时从没有任何按钮按下转换为至少有一个按钮按下时。

对于不支持悬停的输入设备，用户 代理 MUST 还必须在派发 pointerdown 事件之前，先触发名为 pointerover 的指针事件，再触发名为 pointerenter 的指针事件。

用户代理 MUST 当指针发生任何不会触发 pointerdown 或 pointerup 事件的属性变化时，触发一个指针事件，其名称为 pointermove。这包括坐标、压力、切向压力、倾斜、旋转、接触几何（width 与 height）或 组合按键 的任何变化。

用户代理 MAY 延迟派发 pointermove 事件（例如出于性能原因）。 合并事件信息将通过getCoalescedEvents 方法暴露给单个已派发的 pointermove 事件。 这类事件的最终坐标应当用于查找该事件的目标。

用户代理 MUST 触发一个指针事件，其名称为 pointerrawupdate，并且仅能在安全上下文中这样做；当指针发生任何不会触发 pointerdown 或 pointerup 事件的属性变化时触发。此类属性列表参见 pointermove 事件。

与 pointermove 不同，用户代理 SHOULD 尽快并尽可能频繁地派发 pointerrawupdate 事件，频率以 JavaScript 能处理这些事件为限。

pointerrawupdate 事件的 target 可能与 pointermove 事件不同， 因为 pointermove 事件可能被延迟或合并，并且用于查找 target 的事件最终位置可能与其合并事件不同。

请注意：如果事件循环中已经存在另一个具有相同 pointerId 且尚未在事件循环中被派发的 pointerrawupdate，那么 用户代理 MAY 将新的 pointerrawupdate 与该事件合并，而不是创建一个新的 任务。 这可能导致 pointerrawupdate 拥有合并事件，并且它们将作为一个 pointerrawupdate 事件的合并事件，在该事件于事件循环中被处理时尽快交付。 更多信息参见getCoalescedEvents。

就 pointerrawupdate 与 pointermove 的顺序而言： 如果用户代理从平台接收到一次更新，该更新会同时导致 pointerrawupdate 与 pointermove 事件， 则 用户代理 MUST 在派发相应的 pointermove 之前，先派发 pointerrawupdate 事件。

除 target 之外，自上次 pointermove 事件以来，所有已派发的 pointerrawupdate 事件的合并事件列表的串联，在其他事件属性方面，与下一个 pointermove 事件的合并事件相同。 pointerrawupdate 的属性大多与 pointermove 相同，例外是 cancelable：对 pointerrawupdate，它 MUST 为 false。

用户代理 SHOULD 不应为 pointerrawupdate 触发 兼容鼠标事件。

用户代理 MUST 当指针离开活动按钮状态时，触发一个指针事件，其名称为 pointerup。对鼠标而言，即设备从至少有一个按钮按下转换为没有任何按钮按下时。对触摸而言，即从数字化仪移除物理接触时。对笔而言，即在没有任何按钮按下时，笔与数字化仪的物理接触被移除，或在悬停时从至少有一个按钮按下转换为没有任何按钮按下时。

对于不支持悬停的输入设备，用户 代理 MUST 还必须在派发 pointerup 事件之后，触发名为 pointerout 的指针事件，再触发名为 pointerleave 的指针事件。

所有 pointerup 事件的 pressure 值都为 0。

用户代理 MUST 若该指针当前被捕获，还必须隐式释放指针捕获。

用户代理 MUST 当其检测到需要抑制指针事件流的场景时，触发一个指针事件，其名称为 pointercancel。

pointercancel 事件的下列属性值 MUST 与最后一次派发且具有相同 pointerId 的指针事件的值相匹配：width、 height、pressure、tangentialPressure、tiltX、 tiltY、twist、altitudeAngle、azimuthAngle、 pointerType、isPrimary，以及从 [UIEVENTS] 继承的坐标属性。pointercancel 事件中的 coalescedEvents 与 predictedEvents 列表 MUST 为空，并且该事件的 cancelable 属性 MUST 为 false。

用户代理 MUST 在发生以下任一情况时，触发一个指针事件，其名称为 pointerout：

• 为指针确定目标的步骤检测到指针已移动离开某个元素。
• 布局变化导致某个元素的 命中测试边界从一个静止指向设备的未捕获指针之下移开。
• 在用户代理为不支持悬停的设备触发 pointerup 事件之后（参见 pointerup）。
• 用户代理检测到需要抑制指针事件流的场景。

用户代理 MUST 在发生以下任一情况时，触发一个指针事件，其名称为 pointerleave：

• 为指针确定目标的步骤检测到指针已移出某个元素及其所有后代元素。
• 布局变化导致某个元素及其所有后代元素的 命中测试边界从一个静止指向设备的未捕获指针之下移开。
• 在用户代理为不支持悬停的设备触发 pointerup 事件之后（参见 pointerup）。
• 用户代理检测到需要抑制指针事件流的场景。

用户代理 MUST 当某个元素接收到指针捕获时，触发一个指针事件，其名称为 gotpointercapture。该事件会在接收指针捕获的元素上触发。该指针的后续事件将会在此元素上触发。参见设置指针捕获与处理待定指针捕获章节。

用户代理 MUST 在某个指针的指针捕获被释放之后，触发一个指针事件，其名称为 lostpointercapture。该事件 MUST 在捕获被释放后、该指针的任何后续事件之前触发。该事件会在指针捕获被移除的元素上触发。除 click, auxclick 与 contextmenu 事件之外，该指针的所有后续事件在确定事件目标时遵循正常的命中测试机制（不在本规范范围内）。参见释放指针捕获、指针捕获的隐式释放与处理待定指针捕获章节。

本节是对 [UIEVENTS] 中定义的 click、 auxclick 与 contextmenu 事件的补充。这些事件通常与用户界面激活相关联，并且即使来自非指针输入设备（例如键盘）也会触发。

这些事件 MUST 为 PointerEvent 类型，并且必须满足本节其余部分提到的附加要求。

WebIDL[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 的测量单位 MUST 为像素。 这是在大多数操作系统与 实现配置中的最典型情况。

DOM_DELTA_LINE

delta 的测量单位 MUST 为单独的 文本行。这适用于许多表单控件。

DOM_DELTA_PAGE

delta 的测量单位 MUST 为页面， 可以定义为单个屏幕或划分出的页。

deltaX

在默认动作是滚动的用户代理中，wheel 事件的该值 MUST 为沿 x 轴（以像素、行或页为单位）应当滚动的测量值（在事件未被取消的情况下）。 否则，该值是实现特定的测量（以像素、行或页为单位），用于表示滚轮设备绕 x 轴的移动。 该属性的未初始化值 MUST 为 0.0。

deltaY

在默认动作是滚动的用户代理中，wheel 事件的该值 MUST 为沿 y 轴（以像素、行或页为单位）应当滚动的测量值（在事件未被取消的情况下）。 否则，该值是实现特定的测量（以像素、行或页为单位），用于表示滚轮设备绕 y 轴的移动。 该属性的未初始化值 MUST 为 0.0。

deltaZ

在默认动作是滚动的用户代理中，wheel 事件的该值 MUST 为沿 z 轴（以像素、行或页为单位）应当滚动的测量值（在事件未被取消的情况下）。 否则，该值是实现特定的测量（以像素、行或页为单位），用于表示滚轮设备绕 z 轴的移动。 该属性的未初始化值 MUST 为 0.0。

deltaMode

deltaMode 属性包含对 delta 值的测量单位的指示。其 默认值为 DOM_DELTA_PIXEL（像素）。 该属性 MUST 被设置为某个 DOM_DELTA 常量之一，以指示 delta 值的测量单位。 精确的测量与设备、操作系统 以及应用配置有关。 该属性的未初始化值 MUST 为 0。

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

deltaX

见 deltaZ 属性。

deltaY

见 deltaZ 属性。

deltaZ

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

deltaMode

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

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

特别地，当用户代理 观察到该事件没有任何非被动监听器时，它应当仅生成不可取消的 wheel 事件。