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