DeviceOrientationEvent - 提供了运行网页的设备的物理方向信息

这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

DeviceOrientationEvent 为 Web 开发人员提供了运行网页的设备的物理方向信息。

警告: 目前,Firefox 和 Chrome 不会以相同的方式处理坐标。使用它们时要小心。

构造函数

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。

实例

window.addEventListener('deviceorientation', function(event) {
  console.log(event.alpha + ' : ' + event.beta + ' : ' + event.gamma);
});

规范

规范 状态 备注
Device Orientation Events 工作草案 初始规范

桌面浏览器兼容性

特性 Chrome Edge Firefox Internet Explorer Opera Safari
基础支持 71 支持 62 未知 未知 未知
DeviceOrientationEvent() constructor 59 未知 未知 未知 未知 未知
absolute 7 支持 6 未知 未知 未知
alpha 7 支持 6 未知 未知 未知
beta 7 支持 6 未知 未知 未知
gamma 7 支持 6 未知 未知 未知

移动浏览器兼容性

特性 Android Chrome for Android Edge mobile Firefox for Android IE mobile Opera Android iOS Safari
基础支持 支持1 支持1 支持 62 未知 不支持 4.2
DeviceOrientationEvent() constructor 59 59 未知 未知 未知 未知 未知
absolute 支持 支持 支持 6 未知 不支持 4.2
alpha 支持 支持 支持 6 未知 不支持 4.2
beta 支持 支持 支持 6 未知 不支持 4.2
gamma 支持 支持 支持 6 未知 不支持 4.2

1. 在版本 50 之前,Chrome 为该事件提供了绝对值而不是相对值。仍然需要绝对值的开发人员可以使用 ondeviceorientationabsolute 事件。

2. Firefox 3.6,4 和 5 支持的是 mozOrientation 而不是标准的 DeviceOrientationEvent 接口。

相关链接