Element:pointerrawupdate 事件

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

当指针的任何属性发生变化,但这些变化不会触发 pointerdownpointerup 事件时,会触发 pointerrawupdate 事件。有关这些属性的列表,请参阅 pointermove

如果事件循环中已经存在另一个具有相同指针 ID 且尚未分派的 pointerrawupdate 事件,则 pointerrawupdate 事件可能会合并。有关合并事件的信息,请参阅 PointerEvent.getCoalescedEvents() 文档。

pointerrawupdate 旨在用于需要高精度输入处理,并且仅使用合并的 pointermove 事件无法实现平滑交互的应用程序。然而,由于监听 pointerrawupdate 事件可能会影响性能,因此只有当你的 JavaScript 需要高频率事件并能像它们被分派一样快速地处理它们时,才应添加这些监听器。对于大多数用例,其他指针事件类型应该足够了。

此事件会冒泡组合,但不可取消,也没有默认操作。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("pointerrawupdate", (event) => { })

onpointerrawupdate = (event) => { }

事件类型

一个 PointerEvent。继承自 Event

Event UIEvent MouseEvent PointerEvent

事件属性

此接口继承自 MouseEventEvent 的属性。

PointerEvent.altitudeAngle 只读 实验性

表示传感器(指针或手写笔)轴与设备屏幕的 X-Y 平面之间的角度。

PointerEvent.azimuthAngle 只读 实验性

表示 Y-Z 平面与包含传感器(指针或手写笔)轴和 Y 轴的平面之间的角度。

PointerEvent.persistentDeviceId 只读 实验性

生成 PointerEvent 的指向设备的唯一标识符。

PointerEvent.pointerId 只读

导致事件的指针的唯一标识符。

PointerEvent.width 只读

指针接触几何的宽度(X 轴上的大小),以 CSS 像素为单位。

PointerEvent.height 只读

指针接触几何的高度(Y 轴上的大小),单位为 CSS 像素。

PointerEvent.pressure 只读

指针输入在 01 范围内的归一化压力,其中 01 分别表示硬件能够检测到的最小和最大压力。

PointerEvent.tangentialPressure 只读

指针输入(也称为筒压或圆柱应力)在 -11 范围内的归一化切向压力,其中 0 是控制的中间位置。

PointerEvent.tiltX 只读

Y-Z 平面与包含指针(例如笔手写笔)轴和 Y 轴的平面之间的平面角(以度为单位,范围为 -9090)。

PointerEvent.tiltY 只读

X–Z 平面与包含指针(例如,笔尖)轴和 X 轴的平面之间的平面角度(以度为单位,范围为 -9090)。

PointerEvent.twist 只读

指针(例如笔手写笔)围绕其主轴的顺时针旋转角度,以度为单位,值为 0359

PointerEvent.pointerType 只读

指示导致事件的设备类型(鼠标、笔、触摸等)。

PointerEvent.isPrimary 只读

指示此指针是否表示此指针类型的主要指针。

示例

js
addEventListener("pointerrawupdate", (event) => {
  if (event.getCoalescedEvents && event.getCoalescedEvents().length > 1) {
    console.log("Coalesced events:", event.getCoalescedEvents().length);
    for (let coalescedEvent of event.getCoalescedEvents()) {
      // Do something with the coalesced events.
    }
  } else {
    // Do something with the event.
    console.log("Raw event", event);
  }
});

规范

规范
指针事件
# the-pointerrawupdate-event
指针事件
# dom-globaleventhandlers-onpointerrawupdate

浏览器兼容性

另见