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 贡献者修改。