DeviceOrientationEvent
Baseline 2023 *Newly available
Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
* Some parts of this feature may have varying levels of support.
Secure context: This feature is available only insecure contexts (HTTPS), in some or allsupporting browsers.
TheDeviceOrientationEvent
interface of theDevice Orientation Events provides web developers with information from the physical orientation of the device running the web page.
In this article
Constructor
DeviceOrientationEvent.DeviceOrientationEvent()
Creates a new
DeviceOrientationEvent
.
Instance properties
DeviceOrientationEvent.absolute
Read onlyA boolean that indicates whether or not the device is providing orientation data absolutely.
DeviceOrientationEvent.alpha
Read onlyA 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
Read onlyA 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
Read onlyA 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
Non-standardRead onlyA 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
Non-standardRead onlyThe accuracy of the compass means that the deviation is positive or negative. It's usually 10.
Example
window.addEventListener("deviceorientation", (event) => { console.log(`${event.alpha} : ${event.beta} : ${event.gamma}`);});
Specifications
Specification |
---|
Device Orientation and Motion> # deviceorientation> |
Browser compatibility
Loading…