Screen: lockOrientation() Methode
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die lockOrientation() Methode der Screen Schnittstelle sperrt den Bildschirm in eine bestimmte Ausrichtung.
Warnung:
Diese Funktion ist veraltet und sollte vermieden werden. Verwenden Sie stattdessen die Methode ScreenOrientation.lock().
Hinweis: Diese Methode funktioniert nur für installierte Web-Apps oder für Webseiten im Vollbildmodus.
Syntax
lockOrientation(orientation)
Parameter
orientation-
Die Ausrichtung, in der der Bildschirm gesperrt werden soll. Dies ist entweder ein String oder ein Array von Strings. Wenn mehrere Strings übergeben werden, kann sich der Bildschirm nur in den ausgewählten Ausrichtungen drehen.
Die folgenden Strings repräsentieren die möglichen Orientierungsanforderungen, die Sie angeben können:
portrait-primary-
Repräsentiert die Ausrichtung des Bildschirms, wenn er sich im primären Hochformatmodus befindet. Ein Bildschirm wird als im primären Hochformatmodus betrachtet, wenn das Gerät in seiner normalen Position gehalten wird und diese Position im Hochformat ist oder wenn die normale Position des Geräts im Querformat ist und das Gerät um 90° im Uhrzeigersinn gedreht wird. Die normale Position ist geräteabhängig.
portrait-secondary-
Repräsentiert die Ausrichtung des Bildschirms, wenn er sich im sekundären Hochformatmodus befindet. Ein Bildschirm wird als im sekundären Hochformatmodus betrachtet, wenn das Gerät um 180° von seiner normalen Position gehalten wird und diese Position im Hochformat ist oder wenn die normale Position des Geräts im Querformat ist und das Gerät um 90° gegen den Uhrzeigersinn gedreht wird. Die normale Position ist geräteabhängig.
landscape-primary-
Repräsentiert die Ausrichtung des Bildschirms, wenn er sich im primären Querformatmodus befindet. Ein Bildschirm wird als im primären Querformatmodus betrachtet, wenn das Gerät in seiner normalen Position gehalten wird und diese Position im Querformat ist oder wenn die normale Position des Geräts im Hochformat ist und das Gerät um 90° im Uhrzeigersinn gedreht wird. Die normale Position ist geräteabhängig.
landscape-secondary-
Repräsentiert die Ausrichtung des Bildschirms, wenn er sich im sekundären Querformatmodus befindet. Ein Bildschirm wird als im sekundären Querformatmodus betrachtet, wenn das Gerät um 180° von seiner normalen Position gehalten wird und diese Position im Querformat ist oder wenn die normale Position des Geräts im Hochformat ist und das Gerät um 90° gegen den Uhrzeigersinn gedreht wird. Die normale Position ist geräteabhängig.
portrait-
Repräsentiert sowohl
portrait-primaryals auchportrait-secondary. landscape-
Repräsentiert sowohl
landscape-primaryals auchlandscape-secondary. default-
Repräsentiert entweder
portrait-primaryoderlandscape-primary, abhängig von der natürlichen Ausrichtung der Geräte. Zum Beispiel, wenn die Panelauflösung 1280*800 ist, wirddefaultes im Querformat darstellen, wenn die Auflösung 800*1280 ist, wirddefaultes im Hochformat darstellen.
Hinweis: Es ist möglich, mehrere Sperren gleichzeitig zu setzen. Wenn die Sperre nur für eine Ausrichtung gesetzt ist, wird sich die Bildschirmausrichtung niemals ändern, bis die Bildschirmsperre aufgehoben wird. Andernfalls wird sich die Bildschirmausrichtung ändern, solange die Ausrichtungen den Ausrichtungen entsprechen, auf die das Gerät gesperrt ist.
Rückgabewert
Gibt true zurück, wenn die Ausrichtung berechtigt war, gesperrt zu werden, oder false, wenn die Ausrichtungssperre verweigert wurde. Beachten Sie, dass der Rückgabewert nicht anzeigt, dass die Bildschirmausrichtung tatsächlich gesperrt ist: Es könnte eine Verzögerung geben.
Beispiele
Verwendung mit einem String-Argument
screen.lockOrientationUniversal =
screen.lockOrientation ||
screen.mozLockOrientation ||
screen.msLockOrientation;
if (screen.lockOrientationUniversal("landscape-primary")) {
// Orientation was locked
} else {
// Orientation lock failed
}
Verwendung mit einem Array-Argument
screen.lockOrientationUniversal =
screen.lockOrientation ||
screen.mozLockOrientation ||
screen.msLockOrientation;
if (
screen.lockOrientationUniversal(["landscape-primary", "landscape-secondary"])
) {
// Orientation was locked
} else {
// Orientation lock failed
}
Spezifikationen
Diese Funktion ist nicht Teil einer Spezifikation. Sie ist nicht mehr auf dem Weg, ein Standard zu werden.
Verwenden Sie stattdessen ScreenOrientation.lock().