Screen.lockOrientation()

非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

lockOrientation() は Screen インターフェイスのメソッドで、画面を特定の方向にロックします。

警告: この機能は非推奨であり、仕様をさけてください。代わりに ScreenOrientation.lock() メソッドを使用してください。

メモ: このメソッドはインストールされたウェブアプリまたは全画面モードのウェブページでのみ動作します。

構文

lockOrientation(orientation);

引数

orientation

画面をロックする向きです。文字列または文字列の配列で指定します。複数の文字列を渡したときは、選択した向きでのみ回転できるようになります。

以下の文字列表現が向きとして指定できます。

portrait-primary: 第一ポートレートモードである画面の向きを表します。第一ポートレートモードとは、端末を通常の向きが縦向きの場合と、端末の通常の位置が横向きの場合に時計回りに 90° 回転させた向きの場合です。どの向きが通常の向きであるかは、端末によって異なります。
portrait-secondary: 第二ポートレートモードである画面の向きを表します。第二ポートレートモードとは、端末を通常の向きが縦向きでそこから 180° 回転させた場合と、端末の通常の位置が横向きの場合に反時計回りに 90° 回転させた向きの場合です。どの向きが通常の向きであるかは、端末によって異なります。
landscape-primary: 第一ランドスケープモードである画面の向きを表します。第一ランドスケープモードとは、端末を通常の向きが横向きの場合と、端末の通常の位置が縦向きの場合に時計回りに 90° 回転させた向きの場合です。どの向きが通常の向きであるかは、端末によって異なります。
landscape-secondary: 第二ランドスケープモードである画面の向きを表します。第二ランドスケープモードとは、端末を通常の向きが横向きでそこから 180° 回転させた場合と、端末の通常の位置が縦向きの場合に反時計回りに 90° 回転させた向きの場合です。どの向きが通常の向きであるかは、端末によって異なります。
portrait: portrait-primary と portrait-secondary の両方を表します。
landscape: landscape-primary と landscape-secondary の両方を表します。
default: 端末に自然な向きによって portrait-primary または landscape-primary が選ばれます。たとえば、ディスプレイの解像度が 1280*800 なら、 default は landscape になるでしょうし、800*1280 なら、 default は portrait になるでしょう。

メモ: 複数のロックが同時に指定されることがあります。そのため、 1 つの向きにのみロックがセットされた場合には、画面の向きはロックが解除されるまで決して変更されません。もしそうでなければ、端末がロックされた向きを含む複数の向きの間で、画面の向きが 1 つの向きから別の向きへと移り変わってしまうことになります。

screen.lockOrientationUniversal =
  screen.lockOrientation ||
  screen.mozLockOrientation ||
  screen.msLockOrientation;

if (screen.lockOrientationUniversal("landscape-primary")) {
  // 向きがロックされた
} else {
  // 向きのロックに失敗した
}

`Array` 引数での使用方法

screen.lockOrientationUniversal =
  screen.lockOrientation ||
  screen.mozLockOrientation ||
  screen.msLockOrientation;

if (
  screen.lockOrientationUniversal(["landscape-primary", "landscape-secondary"])
) {
  // 向きがロックされた
} else {
  // 向きのロックに失敗した
}

仕様書

この機能は、どの仕様書にも含まれていません。標準化される予定はありません。

代わりに ScreenOrientation.lock() を使用してください。

ブラウザーの互換性

BCD tables only load in the browser

Screen.lockOrientation()

構文

引数

返値

例

文字列引数での使用方法

`Array` 引数での使用方法

仕様書

ブラウザーの互換性

関連情報