Window: deviceorientation event
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.
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 frische Daten von einem Orientierungssensor zur aktuellen Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind. Diese Daten werden von einem Magnetometer im Gerät erfasst.
Details finden Sie unter Erläuterung zu Orientierung und Bewegungsdaten.
Dieses Ereignis ist nicht abbruchsicher und wird nicht propagiert.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("deviceorientation", (event) => { })
ondeviceorientation = (event) => { }
Ereignistyp
Ein DeviceOrientationEvent. Erbt von Event.
Ereigniseigenschaften
DeviceOrientationEvent.absoluteSchreibgeschützt-
Ein boolescher Wert, der anzeigt, ob das Gerät die Orientierung absolut bereitstellt.
DeviceOrientationEvent.alphaSchreibgeschützt-
Eine Zahl, die die Bewegung des Geräts um die z-Achse repräsentiert, ausgedrückt in Grad mit Werten im Bereich von 0 (inklusive) bis 360 (exklusiv).
DeviceOrientationEvent.betaSchreibgeschützt-
Eine Zahl, die die Bewegung des Geräts um die x-Achse repräsentiert, ausgedrückt in Grad mit Werten im Bereich von -180 (inklusive) bis 180 (exklusiv). Dies repräsentiert die Vorwärts- und Rückwärtsbewegung des Geräts.
DeviceOrientationEvent.gammaSchreibgeschützt-
Eine Zahl, die die Bewegung des Geräts um die y-Achse repräsentiert, ausgedrückt in Grad mit Werten im Bereich von -90 (inklusive) bis 90 (exklusiv). Dies repräsentiert die Links-Rechts-Bewegung des Geräts.
DeviceOrientationEvent.webkitCompassHeadingNicht standardisiert Schreibgeschützt-
Eine Zahl, die den Unterschied zwischen der Bewegung des Geräts um die z-Achse des Weltsystems und der Nordrichtung darstellt, ausgedrückt in Grad mit Werten im Bereich von 0 bis 360.
DeviceOrientationEvent.webkitCompassAccuracyNicht standardisiert Schreibgeschützt-
Die Genauigkeit des Kompasses, angegeben als positive oder negative Abweichung. Sie beträgt normalerweise 10.
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
| Specification |
|---|
| Device Orientation and Motion # deviceorientation |
| Device Orientation and Motion # dom-window-ondeviceorientation |
Browser-Kompatibilität
Loading…