PointerEvent: altitudeAngle 屬性

Baseline 2024
新推出

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

PointerEvent 介面的只讀屬性 altitudeAngle 表示感測器(指標或觸控筆)軸與裝置螢幕 X-Y 平面之間的夾角。海拔角度描述了感測器是垂直於螢幕、平行於螢幕,還是處於兩者之間的某個角度。

根據具體的硬體和平臺,使用者代理很可能只收到一組關於感測器相對於螢幕平面的方向值——要麼是 tiltXtiltY,要麼是 altitudeAngleazimuthAngle

The azimuth angle of a pointer compared to the altitude angle

有關此屬性的更多說明,請參閱 規範中的圖 4

一個弧度單位的角度,範圍在 0π/2 之間,其中 0 表示平行於裝置表面(X-Y 平面),π/2 表示垂直於表面。預設值為 π/2(垂直於表面),這與觸控事件中的 altitudeAngle(預設為 0,即平行於表面)不同。對於不報告傾斜或角度的硬體和平臺,值為 π/2

示例

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

規範

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

瀏覽器相容性

另見