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

浏览器兼容性

另见