DeviceOrientationEvent

基线 2023

新功能

2023 年 9 月起,此功能在最新的设备和浏览器版本中有效。此功能可能在较旧的设备或浏览器中无法正常工作。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中可用。

DeviceOrientationEvent设备方向事件 的接口,它为 Web 开发人员提供运行网页的设备物理方向信息。

Event DeviceOrientationEvent

构造函数

DeviceOrientationEvent.DeviceOrientationEvent()

创建一个新的 DeviceOrientationEvent

实例属性

DeviceOrientationEvent.absolute 只读

一个布尔值,表示设备是否提供绝对方向数据。

DeviceOrientationEvent.alpha 只读

一个表示设备绕 Z 轴运动的数字,以度为单位表示,值范围为 0(含)到 360(不含)。

DeviceOrientationEvent.beta 只读

一个表示设备绕 X 轴运动的数字,以度为单位表示,值范围为 -180(含)到 180(不含)。这表示设备的前后运动。

DeviceOrientationEvent.gamma 只读

一个表示设备绕 Y 轴运动的数字,以度为单位表示,值范围为 -90(含)到 90(不含)。这表示设备的左右运动。

DeviceOrientationEvent.webkitCompassHeading 非标准 只读

一个数字表示设备绕世界系统 Z 轴运动与北方方向之间的差异,以度为单位表示,值范围为 0 到 360。

DeviceOrientationEvent.webkitCompassAccuracy 非标准 只读

指南针的精度意味着偏差是正数或负数。通常为 10。

示例

js
window.addEventListener("deviceorientation", (event) => {
  console.log(`${event.alpha} : ${event.beta} : ${event.gamma}`);
});

规范

规范
设备方向和运动
# deviceorientation

浏览器兼容性

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

另请参阅