From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/screen/lockorientation/index.html | 115 +++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 files/ja/web/api/screen/lockorientation/index.html (limited to 'files/ja/web/api/screen/lockorientation') diff --git a/files/ja/web/api/screen/lockorientation/index.html b/files/ja/web/api/screen/lockorientation/index.html new file mode 100644 index 0000000000..19fbbaf291 --- /dev/null +++ b/files/ja/web/api/screen/lockorientation/index.html @@ -0,0 +1,115 @@ +--- +title: Screen.lockOrientation() +slug: Web/API/Screen/lockOrientation +tags: + - API + - CSSOM View + - Method + - NeedsUpdate + - Screen Orientation + - screen + - メソッド +translation_of: Web/API/Screen/lockOrientation +--- +

{{APIRef("Screen Orientation API")}}{{Deprecated_Header}}

+ +

lockOrientation() は {{DOMxRef("Screen")}} インターフェイスのメソッドで、画面を特定の方向にロックします。代わりに {{DOMxRef("ScreenOrientation.lock()")}} メソッドを使用してください。

+ +
+

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

+
+ +

構文

+ +
lockAllowed = window.screen.lockOrientation(orientation);
+ +

引数

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

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

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

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

+
+ +

返値

+ +

向きの固定が許可された場合には true が返り、向きのロックが拒否された場合には false が返ります。返値は、必ずしもスクリーンの向きが実際にロックされていることを示すわけではないことに注意してください。遅延がある可能性があるからです。

+ +

+ +

DOMString 引数での使用方法

+ +
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 {
+  // 向きのロックに失敗した
+}
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('Screen Orientation', 'published/20140220.html#extensions-to-the-screen-interface', 'lockOrientation()')}}{{Spec2('Screen Orientation')}}初回定義 (もう草稿には存在しません)
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Screen.lockOrientation")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf