MDN self-hosted library · e01.org

DeviceOrientationEvent

Device Orientation Events

Device Orientation Events

The DeviceOrientationEvent interface of the provides web developers with information from the physical orientation of the device running the web page.

Constructor

  • DeviceOrientationEvent.DeviceOrientationEvent()
  • : Creates a new DeviceOrientationEvent.

Instance properties

  • DeviceOrientationEvent.absolute
  • : A boolean that indicates whether or not the device is providing orientation data absolutely.
  • DeviceOrientationEvent.alpha
  • : A number representing the motion of the device around the z axis, express in degrees with values ranging from 0 (inclusive) to 360 (exclusive).
  • DeviceOrientationEvent.beta
  • : A number representing the motion of the device around the x axis, express in degrees with values ranging from -180 (inclusive) to 180 (exclusive). This represents a front to back motion of the device.
  • DeviceOrientationEvent.gamma
  • : A number representing the motion of the device around the y axis, express in degrees with values ranging from -90 (inclusive) to 90 (exclusive). This represents a left to right motion of the device.
  • DeviceOrientationEvent.webkitCompassHeading
  • : A number represents the difference between the motion of the device around the z axis of the world system and the direction of the north, express in degrees with values ranging from 0 to 360.
  • DeviceOrientationEvent.webkitCompassAccuracy
  • : The accuracy of the compass means that the deviation is positive or negative. It's usually 10.

Static methods

  • DeviceOrientationEvent.requestPermission()
  • : Requests the user's permission to access device orientation data. Returns a Promise that resolves with a string of "granted" or "denied".

Example

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

Specifications

Browser compatibility

See also

  • Detecting device orientation
  • Orientation and motion data explained
  • DeviceMotionEvent
  • devicemotion event
  • deviceorientation event
  • deviceorientationabsolute event