指针事件

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

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

触发一个 指针事件，其名称为 e，意味着使用属性按照 PointerEvent 接口和 属性和默认动作中的定义设置的 PointerEvent，触发一个事件，其名称为 e。

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

按如下方式确定 事件触发的目标：

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

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

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

如果事件是 pointerdown，关联的 设备是直接操纵设备，并且目标是一个 Element， 那么按照隐式指针捕获中的描述，为此 pointerId 将目标元素设置为指针捕获目标。

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

向确定的目标触发该事件。

将确定的目标保存为给定指针的 previousTarget， 并将 needsOverEvent 标志重置为 false。 如果 previousTarget 在任何时候将不再已连接 [DOM]， 则沿着向 previousTarget 分派事件时对应的事件路径， 将 previousTarget 更新为最近的仍然已连接 [DOM] 的父级， 并将 needsOverEvent 标志设置为 true。

相对于屏幕表面发生移动或其任一 属性发生某种变化的指向设备，会按照指针事件类型中的定义触发各种事件。对于 静止的指向设备（既未相对于屏幕表面移动，也未发生任何 属性变化），如果布局变化影响了该 指针的命中测试目标，用户代理必须 在布局变化之后触发某些边界事件；有关详细信息，请参阅 pointerover、pointerenter、pointerout 和 pointerleave。用户代理可以出于性能 原因延迟触发这些边界事件（例如，避免过多的命中测试或由边界事件监听器导致的布局变化）。

指针事件包含两组互补的属性，用来表示 换能器相对于 X-Y 平面的方向：tiltX / tiltY（在 最初的 Pointer Events 规范中引入），以及 azimuthAngle / altitudeAngle （采用自 触摸事件 - 第 2 级 规范）。

根据具体硬件和平台，用户代理很可能只会接收到一组 表示换能器相对于屏幕平面方向的值——要么是 tiltX / tiltY，要么是 altitudeAngle / azimuthAngle。用户代理必须使用以下算法转换这些值。

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

/* 在 tiltX/tiltY 与 altitudeAngle/azimuthAngle 之间转换 */

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

  let tiltXrad = 0;
  let tiltYrad = 0;

  if (altitudeAngle == 0) {
    // 笔位于 X-Y 平面内
    if (azimuthAngle == 0 || azimuthAngle == 2*Math.PI) {
      // 笔位于 X 轴正方向上
      tiltXrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI/2) {
      // 笔位于 Y 轴正方向上
      tiltYrad = Math.PI/2;
    }
    if (azimuthAngle == Math.PI) {
      // 笔位于 X 轴负方向上
      tiltXrad = -Math.PI/2;
    }
    if (azimuthAngle == 3*Math.PI/2) {
      // 笔位于 Y 轴负方向上
      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;

  // 计算方位角
  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) {
    // 信息不足，无法计算方位角
    azimuthAngle = 0;
  } else {
    // 非边界情况：tiltX 和 tiltY 均不等于 0 或 +-90
    const tanX = Math.tan(tiltXrad);
    const tanY = Math.tan(tiltYrad);

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

  // 计算高度角
  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 {
    // 非边界情况：tiltX 和 tiltY 均不等于 0 或 +-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

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

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

该 用户代理 必须 触发指针事件，名称为 pointerenter，触发条件为发生以下任一情况：

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

该 用户代理 必须 触发指针事件，名称为 pointerdown，触发条件为指针进入 活动按钮状态。对于鼠标，这是指 设备从没有按钮被按下转换为至少有一个按钮被按下的状态。对于触摸，这是指 发生物理接触，接触对象为 数字化器。对于笔，这是指笔 在没有任何按钮被按下时与数字化器发生物理接触，或进行以下转换： 在悬停时，从没有按钮被按下到至少有一个按钮被按下。

对于输入 设备，若其不支持 悬停，则 用户 代理 必须 还要 触发指针 事件，名称为 pointerover，随后触发一个 指针事件，其名称为 pointerenter，然后才可 派发 pointerdown 事件。

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

用户代理可以延迟分派 pointermove 事件（例如，出于性能 原因）。 对于单个已分派的 pointermove 事件，合并事件信息将通过 getCoalescedEvents 方法公开。 应使用这些事件的最终坐标来查找事件目标。

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

与 pointermove 相比，用户代理 应该尽快分派 pointerrawupdate 事件， 并且频率应尽可能高，以 JavaScript 能够处理这些事件的速度为限。

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

请注意，如果已经有另一个 pointerrawupdate 具有相同的 pointerId，并且尚未在 事件循环中分派，则 用户代理可以将新的 pointerrawupdate 与该事件合并，而不是 创建新的任务。 这可能导致 pointerrawupdate 包含合并事件，并且一旦该事件在 事件循环中被处理， 它们都会作为一个 pointerrawupdate 事件的合并事件立即交付。 有关更多信息，请参阅getCoalescedEvents。

就 pointerrawupdate 和 pointermove 的顺序而言， 如果用户代理从平台接收到一个同时导致 pointerrawupdate 和 pointermove 事件的更新， 那么用户代理必须在相应的 pointermove 之前分派 pointerrawupdate 事件。

除 target 外，自上一个 pointermove 事件以来所有已分派 pointerrawupdate 事件的合并事件列表连接起来后， 就其他事件属性而言，与下一个 pointermove 事件的合并事件相同。 pointerrawupdate 的属性 大多与 pointermove 相同，唯一的例外是 cancelable，对于 pointerrawupdate，其必须为 false。

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

该 用户代理 必须 触发指针事件，名称为 pointerup，触发条件为指针离开 活动按钮状态。对于鼠标，这是指 设备从至少有一个按钮被按下转换为没有按钮被按下的状态。对于触摸，这是指 解除物理接触，接触对象为 数字化器。对于笔，这是指笔 在没有按钮被按下时解除与数字化器的物理接触，或进行以下转换： 在悬停时，从至少有一个按钮被按下到没有按钮被按下。

对于输入 设备，若其不支持 悬停，则 用户 代理 必须 还要 触发指针 事件，名称为 pointerout，随后触发一个 指针事件，其名称为 pointerleave，这些操作须晚于 派发 pointerup 事件。

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

该 用户代理 必须 还要 隐式释放指针 捕获，如果该指针当前已被捕获。

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

pointercancel 事件的以下属性值必须与具有相同 pointerId 的最后一个已分派指针事件的值相匹配：width、 height、pressure、tangentialPressure、tiltX、 tiltY、twist、altitudeAngle、azimuthAngle、 pointerType、isPrimary，以及从鼠标事件继承的坐标。 pointercancel 事件中的 coalescedEvents 和 predictedEvents 列表必须为空，并且事件的 cancelable 属性 必须为 false。

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

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

该 用户代理 必须 触发指针事件，名称为 pointerleave，触发条件为发生以下任一情况：

• 用于 确定目标 的指针处理步骤检测到 指针已移出某个元素及其所有后代。
• 一次 布局变化 导致 命中测试 中某个元素及其所有后代的边界 从静止指点设备的未被捕获的指针下方移开。
• 用户代理已触发 pointerup 事件，其对应的 设备 不支持悬停 （参见 pointerup）。
• 用户代理已检测到一种情形，需要 抑制指针事件流。

当一个元素获得指针捕获时，用户代理必须触发一个指针事件，其名称为 gotpointercapture。 此事件在正在获得指针捕获的元素上触发。该指针的后续事件将 在此元素上触发。请参阅设置指针捕获和处理待定指针捕获各节。

在某个指针的指针捕获被释放后，用户代理必须触发一个指针事件，其名称为 lostpointercapture。 在捕获被释放后，该事件必须先于该指针的任何后续事件触发。 此事件在被移除指针捕获的元素上触发。除 click、auxclick 和 contextmenu 事件之外，该指针的所有后续事件都遵循正常的命中测试机制 （不在本规范范围内）来确定事件目标。请参阅释放 指针捕获、隐式释放 指针捕获以及处理待定指针 捕获各节。

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

这些事件必须是 PointerEvent 类型，并且还要遵守 本节其余部分中提到的附加要求。

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

• 鼠标移动时的事件（由 处理 原生鼠标移动）
• 按下鼠标按钮时的事件（由 处理 原生鼠标按下）
• 释放鼠标按钮时的事件（由 处理 原生鼠标释放）
• 一种识别何时应将鼠标按钮按下解释为“点击”的方式（由 处理原生鼠标点击）
  • 例如，作为标志或单独的事件
  • 如果触发单独的“点击”事件，则原生操作系统将在 相应的“鼠标释放”事件之后立即触发该事件，中间不会有任何与鼠标相关的事件
• 一种识别鼠标点击何时为“双击”的方式（由 处理原生鼠标双击）

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

• 相对于原生操作系统桌面的 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. 使用 pos 返回 [CSSOM-View] 的 elementFromPoint() （位于 pos 的最前端 DOM 元素）
   注

   为了考虑 惰性或已禁用 元素，应调用 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 为原生鼠标事件
   编辑者注

   待办。

3. 如果 event.type 是 [ mousedown, mouseup ] 之一，则
   1. 令 mbutton 为来自 native 的、标识按下了哪个鼠标 按钮的 ID
   2. 使用 mbutton 计算 MouseEvent button 属性，并将结果设置为 event.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. 视情况发送 pointerdown 事件，使用 event
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 和发送 click 事件，并传入 target。

1. 令 native 为原生 mousedown
2. 令 target 为事件的 EventTarget
3. 令 mbutton 为 1（默认为主鼠标按钮）
4. 如果 native 有效，则
   1. 令 mbutton 为来自 native 的一个 ID，用于标识按下的是哪个鼠标 按钮
5. 如果 mbutton 是主鼠标按钮，则将 eventType 设置为 "click"，否则设置为 "auxclick"
6. 令 event 为创建 PointerEvent 并传入 eventType 和 target 的结果
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 为创建 PointerEvent 并传入 "dblclick" 和 target 的结果
6. 从原生事件设置 MouseEvent 属性，并传入 event、native
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 为创建可取消的 MouseEvent 并传入 "mouseout" 和上一个鼠标元素的结果
         编者注

         TODO：从 native 设置 mouseout 的属性，以及 CSSOM 属性。

   2. 可以使用 mouseout 发送 pointerout 事件
   3. 在 target 上分派 mouseout
      注

      验证事件被取消时的行为（似乎没有影响）。

   4. 令 leaveElements 为上一个 鼠标 DOM 路径的副本，并移除与 targetDomPath 共有的所有元素。
   5. 对于 leaveElements 中的每个 element，执行
      编者注

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

      1. 令 mouseleave 为创建 不可取消的 MouseEvent 并传入 "mouseleave" 和 element 的结果
      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 为创建可取消的 MouseEvent 并传入 "mouseover" 和 target 的结果
         编者注

         TODO：从 native 设置 mouseout 的属性，以及 CSSOM 属性。

      2. 可以使用 mouseover 发送 pointerover 事件
      3. 在 target 上分派 mouseout
         注

         需要验证事件被取消时的行为（似乎没有影响）。

      4. 令 enterElements 为 targetDomPath 的副本，并移除所有 与上一个鼠标 DOM 路径共有的元素。
      5. 对于 enterElements 中的每个 element，执行
         注

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

         1. 令 mouseenter 为创建 不可取消的 MouseEvent 并传入 "mouseenter" 和 element 的结果
         2. 将 mouseenter.Event.composed 设置为 false
            注

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

         3. 可以使用 mouseenter 发送 pointerenter 事件
            注

            检查影子 DOM 元素的兼容性。Chrome/Linux 会在该 元素和影子根上触发此事件。

         4. 令 result 为在 element 上分派 mouseenter 的结果
      6. 将上一个鼠标元素设置为 target
      7. 将上一个鼠标 DOM 路径设置为 targetDomPath
6. 令 mousemove 为创建可取消的 MouseEvent 并传入 "mousemove" 和 element 的结果
7. 设置 mousemove 的 PointerLock 属性
8. 可以使用 mousemove 发送 pointermove 事件
9. 在 element 上分派 mousemove

1. 令 native 为原生 mousedown 或指针事件
2. 令 target 为事件的 EventTarget
   1. 令 menuevent 为创建 PointerEvent 并传入 "contextmenu"、target 的结果
   2. 如果 native 有效，则
      1. 从原生事件设置 MouseEvent 属性，并传入 native
   3. 令 result 为在 target 上分派 menuevent 的结果
   4. 如果 result 为 true，则显示用户代理的上下文菜单

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

auxclick 事件应仅针对 非主指针 按钮触发（即，当 button 值不为 0， buttons 值大于 1 时）。主按钮 （例如标准鼠标的左键）不得触发 auxclick 事件。有关与 主按钮关联的相应事件，请参阅 click。

auxclick 事件可以由同一元素上的 mousedown 和 mouseup 事件先行发生，而忽略 其他节点类型之间的变化（例如文本节点）。根据 环境配置，如果指向设备按钮按下与 释放之间发生一种或多种 mouseover、 mousemove 和 mouseout 事件类型，则可以分派 auxclick 事件。

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

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

myLink.addEventListener("auxclick", function(e) {
  if (e.button === 1) {
    // 这将阻止默认行为，例如
    // 中键点击链接时打开新标签页。
    e.preventDefault();
    // 执行其他操作来处理中键点击，例如以适合
    // 应用的方式处理在新标签页中打开链接或非链接按钮。
    // 其他应在点击动作时执行的操作，例如关闭标签栏中的标签页，
    // 也可以在此处完成。
  }
});

myDiv.addEventListener("contextmenu", function(e) {
  // 此调用确保不会显示上下文菜单，
  // 从而不会干扰页面接收事件。
  e.preventDefault();
});
myDiv.addEventListener("auxclick", function(e) {
  if (e.button === 2) {
    // 执行其他操作来处理右键点击，例如在应用中打开
    // 自定义上下文菜单。
  }
});

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

click 事件应仅针对主 指针按钮触发（即，当 button 值为 0， buttons 值为 1 时）。 次要按钮 （例如标准鼠标的中键或右键）不得触发 click 事件。有关与 非主按钮关联的相应事件，请参阅 auxclick。

click 事件可以由同一元素上的 mousedown 和 mouseup 事件先行发生，而忽略 其他节点类型之间的变化（例如文本节点）。根据 环境配置，如果指向设备按钮按下与 释放之间发生一种或多种 mouseover、 mousemove 和 mouseout 事件类型，则可以分派 click 事件。click 事件之后还可以 跟随 dblclick 事件。

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

除了与指针设备相关联之外， click 事件类型还必须作为元素 激活的一部分进行分派。

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

• 如果目标具有 关联的激活行为，则默认 动作必须是执行该激活 行为。
• 如果目标 可聚焦，则默认 动作必须是给予该元素文档焦点。

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

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

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

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

当指向设备 按钮在某个元素上被按下时，用户代理必须分派此事件。

当指向设备 移动到某个元素或其后代 元素之一的边界上时，用户代理必须分派此事件。当该 元素或其后代之一移动到主 指向设备下方时，用户代理 也必须分派此事件。此事件类型与 mouseover 类似，但 区别在于它不会冒泡，并且当指针设备从一个元素移动到其某个 后代元素的边界上时，不得分派此事件。

当指向设备 移出某个元素及其所有 后代元素的边界时，用户 代理必须分派此事件。当 该元素或其后代之一移动到不再位于 主指向设备下方时，用户 代理也必须分派此事件。此事件类型与 mouseout 类似， 但区别在于它不会冒泡，并且在指向设备离开 该元素及其所有子元素的边界之前，不得 分派此事件。

当指向设备 位于某个元素上方并发生移动时，用户代理必须分派此事件。指向设备移动时事件的 频率取决于具体实现、设备和 平台，但对于持续的指针设备移动，应该触发多个连续的 mousemove 事件， 而不是针对每次鼠标移动仅触发 单个事件。鼓励实现确定最佳频率， 以在响应性与性能之间取得平衡。

当指向设备 移出某个元素的边界，或者该元素 移动到不再位于主指向设备下方时，用户代理必须分派此事件。 此事件类型与 mouseleave 类似，但区别在于 它会冒泡，并且当指针设备 从一个元素移动到其某个后代元素的边界上时，必须分派此事件。

当指向设备 移动到某个元素的边界上，或者该元素 移动到主指向设备下方时，用户代理必须分派此事件。 此事件类型与 mouseenter 类似，但区别在于 它会冒泡，并且当指针设备移动到 某个元素的边界上，而该元素的祖先元素是同一个事件监听器实例的目标时，必须分派此事件。

当指向设备 按钮在某个元素上被释放时，用户代理必须分派此事件。

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

特别是，当用户代理 观察到 该事件不存在非被动监听器时，应只生成不可取消的 wheel 事件。