PointerEvent:altitudeAngle 属性

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

altitudeAnglePointerEvent 接口的只读属性,表示换能器(指针或触控笔)轴与设备屏幕的 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);
  },
  false,
);

规范

规范
指针事件
# dom-pointerevent-altitudeangle

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅