Bildschrim: Methode lockOrientation()
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
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 des Screen-Interfaces sperrt den Bildschirm in eine bestimmte Ausrichtung.
Warnung:
Diese Funktion ist veraltet und sollte vermieden werden. Verwenden Sie stattdessen die ScreenOrientation.lock()-Methode.
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. Das Übergeben mehrerer Strings ermöglicht es, den Bildschirm nur in den ausgewählten Ausrichtungen zu drehen.
Die folgenden Strings repräsentieren die möglichen Orientierungsanforderungen, die Sie angeben können:
portrait-primary-
Sie repräsentiert die Ausrichtung des Bildschirms, wenn er sich im primären Hochformat befindet. Ein Bildschirm gilt als im primären Hochformat, 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-
Sie repräsentiert die Ausrichtung des Bildschirms, wenn er sich im sekundären Hochformat befindet. Ein Bildschirm gilt als im sekundären Hochformat, wenn das Gerät um 180° von seiner normalen Position im Hochformat gehalten wird, 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-
Sie repräsentiert die Ausrichtung des Bildschirms, wenn er sich im primären Querformat befindet. Ein Bildschirm gilt als im primären Querformat, 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-
Sie repräsentiert die Ausrichtung des Bildschirms, wenn er sich im sekundären Querformat befindet. Ein Bildschirm gilt als im sekundären Querformat, wenn das Gerät um 180° von seiner normalen Position im Querformat gehalten wird, 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-
Sie repräsentiert sowohl
portrait-primaryals auchportrait-secondary. landscape-
Sie repräsentiert sowohl
landscape-primaryals auchlandscape-secondary. default-
Sie repräsentiert entweder
portrait-primaryundlandscape-primary, abhängig von der natürlichen Ausrichtung der Geräte. Zum Beispiel, wenn die Panelauflösung 1280*800 ist, wirddefaultes im Querformat setzen, wenn die Auflösung 800*1280 ist, wirddefaultes ins Hochformat setzen.
Hinweis: Es ist möglich, mehrere Sperren gleichzeitig einzurichten. Wenn die Sperre nur für eine Ausrichtung eingestellt ist, ändert sich die Bildschirmorientierung nie, bis die Ausrichtungssperre aufgehoben wird. Ansonsten ändert sich die Bildschirmorientierung von einer Ausrichtung zur anderen, solange die Orientierungen zu denjenigen gehören, zu denen das Gerät gesperrt wurde.
Rückgabewert
Gibt true zurück, wenn die Ausrichtung gesperrt werden durfte, oder false, wenn die Ausrichtungssperre verweigert wurde. Beachten Sie, dass der Rückgabewert nicht angibt, dass die Bildschirmorientierung tatsächlich gesperrt ist; es kann 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 Teil keiner Spezifikation. Sie ist nicht mehr auf dem Weg, ein Standard zu werden.
Verwenden Sie stattdessen ScreenOrientation.lock().