Element:pointerrawupdate 事件
当指针的任何属性发生变化,但这些变化不会触发 pointerdown 或 pointerup 事件时,会触发 pointerrawupdate 事件。有关这些属性的列表,请参阅 pointermove。
如果事件循环中已经存在另一个具有相同指针 ID 且尚未分派的 pointerrawupdate 事件,则 pointerrawupdate 事件可能会合并。有关合并事件的信息,请参阅 PointerEvent.getCoalescedEvents() 文档。
pointerrawupdate 旨在用于需要高精度输入处理,并且仅使用合并的 pointermove 事件无法实现平滑交互的应用程序。然而,由于监听 pointerrawupdate 事件可能会影响性能,因此只有当你的 JavaScript 需要高频率事件并能像它们被分派一样快速地处理它们时,才应添加这些监听器。对于大多数用例,其他指针事件类型应该足够了。
语法
在诸如 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 |
浏览器兼容性
加载中…