ScreenOrientation
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
* Some parts of this feature may have varying levels of support.
Das ScreenOrientation-Interface der Screen Orientation API bietet Informationen über die aktuelle Ausrichtung des Dokuments.
Ein ScreenOrientation-Instanzobjekt kann über die screen.orientation-Eigenschaft abgerufen werden.
Instanzeigenschaften
ScreenOrientation.typeSchreibgeschützt-
Gibt den aktuellen Ausrichtungstyp des Dokuments zurück, einer von
portrait-primary,portrait-secondary,landscape-primaryoderlandscape-secondary. ScreenOrientation.angleSchreibgeschützt-
Gibt den aktuellen Ausrichtungswinkel des Dokuments zurück.
Instanzmethoden
ScreenOrientation.lock()-
Sperrt die Ausrichtung des beinhaltenden Dokuments auf seine Standardausrichtung und gibt ein
Promisezurück. ScreenOrientation.unlock()-
Entsperrt die Ausrichtung des beinhaltenden Dokuments aus seiner Standardausrichtung.
Ereignisse
Diese Ereignisse können mit addEventListener() gehört oder einem Event-Listener zur Eigenschaft oneventname dieses Interfaces zugewiesen werden.
change-
Wird ausgelöst, wenn sich die Ausrichtung des Bildschirms ändert.
Beispiel
Im folgenden Beispiel hören wir auf ein Ausrichtungs-change-Ereignis und loggen den neuen Bildschirm-Ausrichtungstyp und Winkel.
screen.orientation.addEventListener("change", (event) => {
const type = event.target.type;
const angle = event.target.angle;
console.log(`ScreenOrientation change: ${type}, ${angle} degrees.`);
});
Spezifikationen
| Specification |
|---|
| Screen Orientation # screenorientation-interface |
Browser-Kompatibilität
Loading…