Window: deviceorientation event
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2023 browserübergreifend verfügbar.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das deviceorientation-Ereignis wird ausgelöst, wenn neue Daten von einem Orientierungssensor verfügbar sind, die die aktuelle Orientierung des Geräts im Vergleich zum Erdkoordinatensystem betreffen. Diese Daten werden von einem Magnetometer im Gerät erfasst.
Siehe Erläuterung von Orientierungs- und Bewegungsdaten für Details.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht übertragen.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("deviceorientation", (event) => { })
ondeviceorientation = (event) => { }
Ereignistyp
Ein DeviceOrientationEvent. Erbt von Event.
Beispiele
if (window.DeviceOrientationEvent) {
window.addEventListener(
"deviceorientation",
(event) => {
const rotateDegrees = event.alpha; // alpha: rotation around z-axis
const leftToRight = event.gamma; // gamma: left to right
const frontToBack = event.beta; // beta: front back motion
handleOrientationEvent(frontToBack, leftToRight, rotateDegrees);
},
true,
);
}
function handleOrientationEvent(frontToBack, leftToRight, rotateDegrees) {
// do something amazing
}
Spezifikationen
| Spezifikation |
|---|
| Device Orientation and Motion # deviceorientation |
| Device Orientation and Motion # dom-window-ondeviceorientation |