PointerEvent:altitudeAngle 属性
altitudeAngle
是 PointerEvent
接口的只读属性,表示换能器(指针或触控笔)轴与设备屏幕的 X-Y 平面之间的角度。高度角描述了换能器是垂直于屏幕、平行于屏幕还是介于两者之间的某个角度。
根据具体的硬件和平台,用户代理可能只会收到一组关于换能器相对于屏幕平面的方向值——要么是 tiltX
和 tiltY
,要么是 altitudeAngle
和 azimuthAngle
。
有关此属性的更多说明,请参阅 规范中的图 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 的浏览器中加载。