元素：pointerrawupdate 事件

实验性： 这是一个实验性技术
在生产环境中使用之前，请仔细查看浏览器兼容性表。

安全上下文： 此功能仅在安全上下文 (HTTPS) 中可用，在一些或所有支持的浏览器中。

pointerrawupdate PointerEvent 当指针更改任何不会触发 pointerdown 或 pointerup 事件的属性时触发。有关这些属性的列表，请参阅 pointermove。

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

仅当您的 JavaScript 需要高频率事件并能够像它们被分派一样快地处理它们时，才应添加 pointerrawupdate 事件的监听器。对于大多数用例，其他指针事件类型应该足够，因为添加 pointerrawupdate 事件监听器可能会对性能产生影响。

语法

在像 addEventListener() 这样的方法中使用事件名称，或者设置事件处理程序属性。

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

onpointerrawupdate = (event) => {};

事件类型

一个 PointerEvent。继承自 Event。

事件属性

此接口继承自 MouseEvent 和 Event 的属性。

PointerEvent.altitudeAngle 只读实验性: 表示传感器（指针或手写笔）轴与设备屏幕的 X-Y 平面之间的角度。
PointerEvent.azimuthAngle 只读实验性: 表示 Y-Z 平面与包含传感器（指针或手写笔）轴和 Y 轴的平面之间的角度。
PointerEvent.persistentDeviceId 只读实验性: 生成 PointerEvent 的指向设备的唯一标识符。
PointerEvent.pointerId 只读: 导致事件的指针的唯一标识符。
PointerEvent.width 只读: 指针接触几何形状的宽度（X 轴上的大小），以 CSS 像素为单位。
PointerEvent.height 只读: 指针接触几何形状的高度（Y 轴上的大小），以 CSS 像素为单位。
PointerEvent.pressure 只读: 指针输入的归一化压力，范围为 0 到 1，其中 0 和 1 分别代表硬件能够检测到的最小和最大压力。
PointerEvent.tangentialPressure 只读: 指针输入的归一化切向压力（也称为桶压或圆柱体应力），范围为 -1 到 1，其中 0 是控件的中立位置。
PointerEvent.tiltX 只读: Y–Z 平面与包含指针（例如笔式手写笔）轴和 Y 轴的平面之间的平面角（以度为单位，范围为 -90 到 90）。
PointerEvent.tiltY 只读: X–Z 平面与包含指针（例如笔式手写笔）轴和 X 轴的平面之间的平面角（以度为单位，范围为 -90 到 90）。
PointerEvent.twist 只读: 指针（例如笔式手写笔）绕其主轴的顺时针旋转，以度为单位，值范围为 0 到 359。
PointerEvent.pointerType 只读: 指示导致事件的设备类型（鼠标、笔、触摸等）。
PointerEvent.isPrimary 只读: 指示指针是否代表此指针类型的首要指针。

示例

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

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅

相关事件