PointerEvent: azimuthAngle 屬性

Baseline 2024

新推出

自 2024 年 12 月起，此功能可在最新的裝置和瀏覽器版本上使用。此功能可能無法在舊版裝置或瀏覽器上使用。

azimuthAngle 是 PointerEvent 介面的一個只讀屬性，它表示 Y-Z 平面與包含換能器（指標或觸控筆）軸線和 Y 軸的平面之間的角度。

根據具體的硬體和平臺，使用者代理很可能只會收到一組相對於螢幕平面的換能器方向值——要麼是 tiltX 和 tiltY，要麼是 altitudeAngle 和 azimuthAngle。

The azimuth angle of a pointer compared to the altitude angle

有關此屬性的更多說明，請參閱規範中的圖 5。

值

一個弧度值，介於 0 和 2π 之間。其中 0 表示換能器的尖端指向 X-Y 平面上 X 值增大的方向（俯視時指向“3 點鐘”方向），並且隨著順時針方向（“6 點鐘”方向為 π/2，“9 點鐘”方向為 π，“12 點鐘”方向為 3π/2）值逐漸增大。

當換能器垂直於表面時（altitudeAngle 為 π/2），該值為 0。對於不報告傾斜或角度的硬體和平臺，該值為 0。

someElement.addEventListener("pointerdown", (event) => {
  process_angles(event.altitudeAngle, event.azimuthAngle);
});

規範
指標事件 # dom-pointerevent-azimuthangle

此頁面最後修改於 2025年9月18日，由 MDN 貢獻者修改。