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 |
瀏覽器相容性
載入中…