Window: deviceorientation Ereignis

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 neue Daten von einem Orientierungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind. Diese Daten werden von einem Magnetometer im Gerät erfasst.

Siehe Orientierungs- und Bewegungsdaten erklärt für Details.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-Eigenschaft.

js
addEventListener("deviceorientation", (event) => {});

ondeviceorientation = (event) => {};

Ereignistyp

Ein DeviceOrientationEvent. Erbt von Event.

Event DeviceOrientationEvent

Ereigniseigenschaften

DeviceOrientationEvent.absolute Nur lesbar

Ein boolescher Wert, der angibt, ob das Gerät Orientierungsdaten absolut liefert.

DeviceOrientationEvent.alpha Nur lesbar

Eine Zahl, die die Bewegung des Geräts um die z-Achse darstellt, ausgedrückt in Grad mit Werten von 0 (einschließlich) bis 360 (ausschließlich).

DeviceOrientationEvent.beta Nur lesbar

Eine Zahl, die die Bewegung des Geräts um die x-Achse darstellt, ausgedrückt in Grad mit Werten von -180 (einschließlich) bis 180 (ausschließlich). Dies repräsentiert die Vorwärts-Rückwärts-Bewegung des Geräts.

DeviceOrientationEvent.gamma Nur lesbar

Eine Zahl, die die Bewegung des Geräts um die y-Achse darstellt, ausgedrückt in Grad mit Werten von -90 (einschließlich) bis 90 (ausschließlich). Dies repräsentiert die Links-Rechts-Bewegung des Geräts.

DeviceOrientationEvent.webkitCompassHeading Nur lesbar

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 von 0 bis 360.

DeviceOrientationEvent.webkitCompassAccuracy Nur lesbar

Die Genauigkeit des Kompasses, angegeben als positive oder negative Abweichung. In der Regel ist es 10.

Beispiele

js
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,
  );
}

const handleOrientationEvent = (frontToBack, leftToRight, rotateDegrees) => {
  // do something amazing
};

Spezifikationen

Specification
Device Orientation and Motion
# deviceorientation
Device Orientation and Motion
# ref-for-dom-window-ondeviceorientation

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch