指针事件

5.1 PointerEvent接口

dictionary PointerEventInit : MouseEventInit {
        long        pointerId = 0;
        double      width = 1;
        double      height = 1;
        float       pressure = 0;
        float       tangentialPressure = 0;
        long        tiltX = 0;
        long        tiltY = 0;
        long        twist = 0;
        DOMString   pointerType = "";
        boolean     isPrimary = false;
    };
    
    [Constructor(DOMString type, optional PointerEventInit eventInitDict), Exposed=Window]
    interface PointerEvent : MouseEvent {
        readonly        attribute long        pointerId;
        readonly        attribute double      width;
        readonly        attribute double      height;
        readonly        attribute float       pressure;
        readonly        attribute float       tangentialPressure;
        readonly        attribute long        tiltX;
        readonly        attribute long        tiltY;
        readonly        attribute long        twist;
        readonly        attribute DOMString   pointerType;
        readonly        attribute boolean     isPrimary;
    };

5.2 指针事件类型

以下是本规范中定义的事件类型。

在主要指针的情况下，这些事件（gotpointercapture和 lostpointercapture除外）也可能触发兼容鼠标事件。

9.1 touch-action CSS属性

touch-action CSS属性决定触控输入可能触发由用户代理提供的默认行为。这包括但不限于平移或缩放等行为。请参阅touch-action值一节。

在执行用户代理触控行为期间，用户代理不得为指针触发后续指针事件。用户代理必须触发名为pointercancel的指针事件（随后触发pointerout事件和一个或多个pointerleave事件），以便在以下所有条件都成立时结束该指针的事件流：

• 用户代理已确定（通过本规范范围之外的方法）触控输入将用于触控行为，
• 已为指针发送pointerdown事件，并且
• 尚未为指针发送pointerup或pointercancel事件（在上述pointerdown之后）。

9.2 确定支持的触控行为

当用户触摸一个元素时，该触摸的效果由touch-action属性的值以及该元素及其祖先的默认触控行为确定，如下所示：

• 如果触控行为在元素的坐标空间中被允许，则触控行为符合元素的touch-action。请注意，如果应用了CSS变换，元素的坐标空间可能与屏幕坐标不同，从而影响此处的符合性；例如，X轴旋转90度的元素相对于屏幕将平行于屏幕坐标的Y轴。
• 如果触控行为符合命中测试元素及其最近的具有默认触控行为的祖先的touch-action属性（包括命中测试元素和具有默认触控行为的元素），则支持触控行为。
• 一旦开始触控行为，用户代理已经确定是否应将该行为处理为用户代理触控行为，任何对相关touch-action值的更改都将在触控行为持续期间被忽略。例如，作为pointerdown处理程序脚本的一部分，将元素的touch-action值从auto程序更改为none不会导致用户代理在该指针处于活动状态时中止或抑制该触控的任何默认触控行为。

9.3 touch-action值的详细信息

auto

用户代理可以确定任何允许的触控行为，例如触控开始时的视口平移和缩放。

none

开始于元素上的触控不得触发默认触控行为。

pan-x
pan-y

用户代理可以仅将触控视为滚动开始的目的，这些滚动必须在所有列出的值指定的方向中之一开始。一旦滚动开始，用户可以反转方向，即使在反转方向开始的滚动被禁止时也是如此。相比之下，当滚动限制为仅沿单个轴开始时（例如pan-y），在滚动过程中无法更改轴。

manipulation

用户代理可以仅将触控视为滚动和连续缩放的目的。auto支持的任何其他行为不在本规范范围之内。

10.2 设置指针捕获

通过调用element.setPointerCapture(pointerId)方法在元素上设置指针捕获。当调用此方法时，用户代理必须运行以下步骤：

1. 如果作为方法参数提供的pointerId与任何活动指针不匹配，则抛出DOMException，其名称为NotFoundError。
2. 如果调用此方法的Element未连接（[DOM4]），则抛出名称为InvalidStateError的异常。
3. 如果在文档有锁定元素时调用此方法（[PointerLock]），则抛出名称为InvalidStateError的异常。
4. 如果指针未处于活动按钮状态，则终止这些步骤。
5. 对于指定的pointerId，将待处理的指针捕获目标覆盖设置为调用此方法的Element。

10.3 释放指针捕获

通过调用element.releasePointerCapture(pointerId)方法在元素上显式释放指针捕获。当调用此方法时，用户代理必须运行以下步骤：

1. 如果作为方法参数提供的pointerId与任何活动指针不匹配且这些步骤不是由于隐式释放指针捕获而被调用的，则抛出DOMException，其名称为NotFoundError。
2. 如果对于具有指定pointerId的Element，hasPointerCapture为false，则终止这些步骤。
3. 对于指定的pointerId，清除待处理的指针捕获目标覆盖，如果已设置。

10.4 隐式指针捕获

某些输入设备（如触摸屏）实现了“直接操作”的隐喻，其中指针主要作用于其激活的UI元素（提供直接接触的物理错觉，而不是通过概念上漂浮在UI上方的光标进行间接接触）。这些设备由InputDeviceCapabilities.pointerMovementScrolls 属性标识，并应具有如下“隐式指针捕获”行为。

直接操作设备应当像在目标元素上调用了setPointerCapture一样行为，发生在任何pointerdown监听器调用之前。可以使用hasPointerCapture API（例如，在任何pointerdown监听器内）确定是否已发生此操作。如果在下一个指针事件触发前未调用releasePointerCapture，则将向目标派发一个gotpointercapture事件（正常情况下），表明捕获已激活。

10.5 隐式释放指针捕获

在触发pointerup或pointercancel事件后，用户代理必须清除该pointerup或pointercancel事件刚刚调度的pointerId的待处理的指针捕获目标覆盖， 并运行处理待处理的指针捕获步骤，如有必要，触发lostpointercapture事件。 在运行处理待处理的指针捕获步骤后， 如果指针支持悬停，用户代理必须发送对应的边界事件以反映没有捕获情况下指针的当前位置。

如果用户代理支持触发click事件 （请参阅兼容鼠标事件）， 并且在隐式释放情况下同时触发click和lostpointercapture事件， click事件应在lostpointercapture事件之前触发。

当指针捕获目标覆盖不再连接时（[DOM4]）， 待处理的指针捕获目标覆盖和指针捕获目标覆盖节点应被清除， 并且应在文档上触发对应捕获指针的lostpointercapture事件。

当在元素上成功应用指针锁定（[PointerLock]），用户代理必须运行步骤，仿佛已经调用了releasePointerCapture()方法，如果有任何元素被设置为捕获或待捕获。

11.1 跟踪传统鼠标指针的有效位置

虽然只有 主指针 能够生成兼容的鼠标事件，但 多个主指针 可以同时激活，每个指针产生自己的兼容鼠标事件。由于所有这些兼容事件对于 MouseEvent 代码来说似乎来自单一的鼠标设备，用户代理被鼓励保证从单一设备的角度来看，兼容鼠标事件是一致的。对于鼠标过渡事件（即 mouseover、mouseout、mouseenter 和 mouseleave），这意味着每个事件目标的进入/退出状态是有效的，如 [UIEVENTS] 所暗示的。用户代理 应当 通过在文档中维护 传统鼠标指针的有效位置 来保证这一点，如下所述。

在触发 pointerdown、pointerup 或 pointermove 事件，或在 window 上触发 pointerleave 事件之前，用户代理 应当 执行以下步骤：

1. 让 T 为正在分发的 pointerdown、pointerup 或 pointermove 事件的目标。对于 pointerleave 事件，取消设置 T。
2. 如果 T 和当前 有效的传统鼠标指针位置 都未设置或相等，则终止这些步骤。
3. 根据 [UIEVENTS] 为鼠标从当前 有效的传统鼠标指针位置 移动到 T 触发 mouseover、mouseout、mouseenter 和 mouseleave 事件。将当前 有效的传统鼠标指针位置 或 T 的未设置值视为窗口外的鼠标位置。
4. 将 有效的传统鼠标指针位置 设置为 T。

11.2 支持悬停的设备的映射

每当用户代理为支持悬停的设备调度指针事件时，它应运行以下步骤：

1. 如果要调度的指针事件的isPrimary属性为false，则调度指针事件并终止这些步骤。
2. 如果要调度的指针事件是pointerdown、pointerup或pointermove事件，或在window上调度的pointerleave事件，则按照追踪传统鼠标指针的有效位置中描述的方式调度兼容性鼠标过渡事件。
3. 调度指针事件。
4. 如果调度的指针事件是pointerdown并且事件被取消，则为此pointerType设置PREVENT MOUSE EVENT标志。
5. 如果未为此pointerType设置PREVENT MOUSE EVENT标志，并且调度的指针事件是：
   • pointerdown，则触发mousedown事件。
   • pointermove，则触发mousemove事件。
   • pointerup，则触发mouseup事件。
   • pointercancel，则在window上触发mouseup事件。
6. 如果调度的指针事件是pointerup或pointercancel，则清除此pointerType的PREVENT MOUSE EVENT标志。

11.3 不支持悬停的设备的映射

某些设备（如大多数触摸屏）不支持在非活动状态下悬停某个坐标（或一组坐标）。许多仅针对鼠标事件编写的现有内容假设鼠标正在产生这些事件，因此通常以下特性是真实的：

• 输入可以独立于激活进行悬停（例如，移动未按下任何按钮的鼠标光标）。
• 输入可能会在单击元素之前产生mousemove事件。

这要求用户代理为这些类型的输入设备提供不同的映射。每当用户代理为不支持悬停的设备调度指针事件时，它应运行以下步骤：

1. 如果要调度的指针事件的isPrimary属性为false，则调度指针事件并终止这些步骤。
2. 如果要调度的指针事件是pointerover并且尚未为此指针调度pointerdown事件，则触发mousemove事件（以与传统仅支持鼠标的代码兼容）。
3. 如果要调度的指针事件是pointerdown、pointerup或pointermove事件，或在window上调度的pointerleave事件，则按照追踪传统鼠标指针的有效位置中描述的方式调度兼容性鼠标过渡事件。
4. 调度指针事件。
5. 如果调度的指针事件是pointerdown并且事件被取消，则为此pointerType设置PREVENT MOUSE EVENT标志。
6. 如果未为此pointerType设置PREVENT MOUSE EVENT标志，并且调度的指针事件是：
   • pointerdown，则触发mousedown事件。
   • pointermove，则触发mousemove事件。
   • pointerup，则触发mouseup事件。
   • pointercancel，则在window上触发mouseup事件。
7. 如果调度的指针事件是pointerup或pointercancel，则清除此pointerType的PREVENT MOUSE EVENT标志。