Bildschirm: 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.

Die lockOrientation()-Methode der Screen-Schnittstelle sperrt den Bildschirm in eine angegebene Ausrichtung.

Warnung: Dieses Feature 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. Durch Übergeben mehrerer Strings kann der Bildschirm nur in den ausgewählten Ausrichtungen gedreht werden.

Die folgenden Strings repräsentieren die möglichen Ausrichtungsvorgaben, die Sie angeben können:

portrait-primary: Es repräsentiert die Ausrichtung des Bildschirms im primären Hochformatmodus. Ein Bildschirm befindet sich im primären Hochformatmodus, 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 gehalten wird. Die normale Position ist geräteabhängig.
portrait-secondary: Es repräsentiert die Ausrichtung des Bildschirms im sekundären Hochformatmodus. Ein Bildschirm befindet sich im sekundären Hochformatmodus, wenn das Gerät um 180° von seiner normalen Position gedreht wird und diese Position im Hochformat ist, oder wenn die normale Position des Geräts im Querformat ist und das Gerät gegen den Uhrzeigersinn um 90° gedreht gehalten wird. Die normale Position ist geräteabhängig.
landscape-primary: Es repräsentiert die Ausrichtung des Bildschirms im primären Querformatmodus. Ein Bildschirm befindet sich im primären Querformatmodus, 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 gehalten wird. Die normale Position ist geräteabhängig.
landscape-secondary: Es repräsentiert die Ausrichtung des Bildschirms im sekundären Querformatmodus. Ein Bildschirm befindet sich im sekundären Querformatmodus, wenn das Gerät um 180° von seiner normalen Position gedreht wird und diese Position im Querformat ist, oder wenn die normale Position des Geräts im Hochformat ist und das Gerät gegen den Uhrzeigersinn um 90° gedreht gehalten wird. Die normale Position ist geräteabhängig.
portrait: Es repräsentiert sowohl portrait-primary als auch portrait-secondary.
landscape: Es repräsentiert sowohl landscape-primary als auch landscape-secondary.
default: Es repräsentiert entweder portrait-primary oder landscape-primary, abhängig von der natürlichen Ausrichtung der Geräte. Zum Beispiel, wenn die Panel-Auflösung 1280*800 ist, wird default es im Querformat einstellen, wenn die Auflösung 800*1280 ist, wird default es im Hochformat einstellen.

Hinweis: Es ist möglich, mehrere Sperren gleichzeitig zu setzen. Wenn die Sperre nur für eine Ausrichtung gesetzt ist, wird sich die Bildschirmorientierung niemals ändern, bis die Bildschirmorientierung entsperrt wird. Andernfalls wird die Bildschirmorientierung von einer Ausrichtung zur anderen wechseln, solange sich die Ausrichtungen unter denen befinden, die das Gerät gesperrt wurden.

Rückgabewert

Gibt true zurück, wenn die Ausrichtung zur Sperrung autorisiert wurde, oder false, wenn die Ausrichtungssperre verweigert wurde. Beachten Sie, dass der Rückgabewert nicht anzeigt, 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
}