大网数据广告活动
Web 标准与前端开发

Window:deviceorientation 事件

· 52CE 我爱测

**`deviceorientation`** 事件在方向传感器输出新数据的时候触发。其数据系传感器与地球坐标系相比较所得,也就是说在设备上可能会采用设备地磁计的数据。

deviceorientation 事件在方向传感器输出新数据的时候触发。其数据系传感器与地球坐标系相比较所得,也就是说在设备上可能会采用设备地磁计的数据。

参见有关方向与运动信息的说明。

该事件不可取消也不会冒泡。

语法

在 EventTarget.addEventListener 方法中使用事件名称,或使用事件处理器属性。

addEventListener("deviceorientation", (event) => {});

ondeviceorientation = (event) => {};

事件类型

一个 DeviceOrientationEvent。继承了 Event。

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。

示例

if (window.DeviceOrientationEvent) {
  window.addEventListener(
    "deviceorientation",
    function (event) {
      // alpha: rotation around z-axis
      var rotateDegrees = event.alpha;
      // gamma: left to right
      var leftToRight = event.gamma;
      // beta: front back motion
      var frontToBack = event.beta;

      handleOrientationEvent(frontToBack, leftToRight, rotateDegrees);
    },
    true,
  );
}

var handleOrientationEvent = function (
  frontToBack,
  leftToRight,
  rotateDegrees,
) {
  // do something amazing
};

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。