Window: deviceorientation-Ereignis
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 eines Orientierungssensors zur aktuellen Ausrichtung des Geräts relativ zum Erdkoordinatensystem verfügbar sind. Diese Daten werden von einem Magnetometer im Gerät erfasst.
Weitere Informationen finden Sie unter Erläuterung von Ausrichtungs- und Bewegungsdaten.
Dieses Ereignis kann nicht abgebrochen werden und breitet sich nicht nach oben aus.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("deviceorientation", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft des Interfaces zuweisen:
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 |