画面の向き

画面は、以下のいずれかの 画面の向き であるか、ロック されることがあります。

任意

画面は、デバイスのオペレーティングシステムまたはエンドユーザーによって許可された 任意の向きにユーザーが回転できます。

デフォルト（ロック解除済み）

画面がロック解除されているときのデバイスのデフォルトの動作 （すなわち、アクティブな向きのロックが nullである場合）です。この 向きは、デバイスのオペレーティングシステム、ユーザーエージェント、 エンドユーザーの制御によって決定されるか、場合によっては インストール済みウェブアプリケーションによって設定されます。たとえば、 画面の 向きのロックが解除され、ユーザーがデバイスを回転させた場合、一部の デバイスでは、向きの変更がportrait-primary、 landscape-primary、およびlandscape-secondaryに 制限され、 portrait-secondaryには変更できないことがあります。

横向き

画面のアスペクト比は、幅が高さより大きいものです。

自然

デバイスのディスプレイにおいて向きの角度を測定する基準となる 向きであり、ユーザーエージェント、ユーザー、 オペレーティングシステム、または画面自体によって決定されます。たとえば、 コンピューターモニターの基準となる向きは通常 landscape-primaryである一方、携帯 電話の基準となる向きは通常portrait-primaryです。

注記

ユーザーエージェントが自然な向きを決定する方法は 実装定義であり、プラットフォームによって異なります。一部のユーザーエージェントは、 デバイスクラスごとに固定された向きを使用します（たとえば、 ハンドセットではportrait-primary、landscape-primaryは タブレット、デスクトップ、およびテレビで使用されます）が、画面の 物理的な寸法とデフォルトの回転から導出するものもあります。正方形または折りたたみ式の 画面など、明確な直立方向を持たないデバイスでは、そのため自然な向きがユーザーエージェント間で 異なる場合があります。

縦向き

画面のアスペクト比は、高さが幅より大きいものです。

プライマリー

縦向き または横向きのいずれかにおける、デバイスの画面の自然な向きです。

セカンダリー

縦向きまたは横向きにおける、 デバイスの画面のプライマリーの向きとは反対の向きです。

出力デバイスの画面には、次の概念が関連付けられています:

アクティブな向きロック

画面がロックされている画面の向き（OrientationLockTypeとして表される）、またはアンロック時はnull。

現在の向きの角度

画面が自然な向きから反時計回りに回転している角度（度）。この角度は画面の向き値リストから導出されます。

現在の向きタイプ

画面の画面の向き（OrientationTypeとして表される）。

以下の画面の向きの値リストは、異なる 自然な向きを持つ画面について、各画面の向きの種類に 関連付けられる角度を標準化します：

自然な向きが縦向きである画面の場合：

• portrait-primary：0°
• landscape-primary：90°
• portrait-secondary：180°
• landscape-secondary：270°

自然な向きが横向きである画面の場合：

• landscape-primary：0°
• portrait-primary：90°
• landscape-secondary：180°
• portrait-secondary：270°

Document インターフェイスは、次の内部スロットで拡張されます:

ロック前条件 は、画面の向きのロックを許可する前に ユーザーエージェント が MAY 課すことができる任意の要件である。 一般的なロック前条件には、ドキュメントがフルスクリーンモードであること、またはインストール済みのウェブアプリケーションの一部であることなどが含まれる。具体例は 10. Web Application Manifest との相互作用 および 9. Fullscreen API との相互作用 を参照。

lock() メソッドが OrientationLockType orientation を指定して呼び出されたとき、ユーザーエージェント は MUST 次の手順を実行する。

1. document を、this の 関連グローバルオブジェクト の 関連付けられた Document とする。
2. 共通の安全性チェック を document に対して実行する。例外 が スロー された場合は、その例外で 拒否されたプロミス を返し、これらの手順を中止する。
3. もし ユーザーエージェント が画面の向きを orientation にロックすることをサポートしていない場合は、 拒否されたプロミス（ "NotSupportedError" DOMException）を返し、これらの手順を中止する。
4. もし ユーザーエージェント が、画面の向きを ロック するために document とその関連する 閲覧コンテキスト が ロック前条件 を満たすことを要求し、 その条件が満たされていない場合は、"NotAllowedError" DOMException で 拒否されたプロミス を返し、これらの手順を中止する。
5. もし document の [[orientationPendingPromise]] が null でない場合、現在のロックのプロミスを拒否して無効化する（ document に対して "AbortError" で）。
6. document の [[orientationPendingPromise]] を 新しいプロミス に設定する。
7. 向きロックを適用する： orientation を document に適用する。
8. document の [[orientationPendingPromise]] を返す。

unlock() メソッドが呼び出されたとき、ユーザーエージェントは MUST 次の手順を実行しなければなりません:

1. document に this の 関連グローバルオブジェクト の 関連付けられた Document を代入します。
2. document で 共通安全性チェック を実行します。例外 が スロー された場合、その例外を再スローし、これらの手順を中止します。
3. screen の アクティブな向きロック が null の場合、 undefined を返します。
4. document の [[orientationPendingPromise]] が null でない場合、現在のロックプロミスを却下しnullにする を document で "AbortError" で実行します。
5. 向きロックを適用 を null と document で実行します。

共通安全性チェックは、Document document に対して次の手順を実行します。

1. もし document が ユーザーの注目を受けているトップレベルのトラバーサブルの完全にアクティブな子孫 でない場合、スロー する "InvalidStateError" DOMException。
2. もし document に サンドボックス化された画面の向きロック閲覧コンテキスト・フラグ が設定されている場合、 スロー する "SecurityError" DOMException。
3. もし document の 可視性状態 が "hidden" の場合、スロー する "SecurityError" DOMException。

取得時、type 属性は this の [[type]] を返します。

取得時、angle 属性は this の [[angle]] を返します。

閲覧コンテキスト context が作成されるとき、ユーザーエージェントは MUST 以下を実行しなければなりません:

1. screenOrientation を context の 関連付けられた ScreenOrientation にします。
2. screenOrientation の [[initialType]] 内部スロットを、画面の 現在の向きの種類 に初期化します。
3. screenOrientation の [[type]] 内部スロットを、画面の 現在の向きの種類 に初期化します。
4. screenOrientation の [[angle]] 内部スロットを、画面の 現在の向きの角度 に初期化します。

手順で、現在のロックプロミスを却下しnullにすることが Document document と DOMString exceptionName で要求された場合、ユーザーエージェントは MUST 以下を実行しなければなりません:

1. アサート: [[orientationPendingPromise]] は null でないこと。
2. promise に、document の [[orientationPendingPromise]] を代入します。
3. グローバルタスクをキューに追加します。DOM操作タスクソース上で document の 関連グローバルオブジェクトを用い、reject を使い promise を新しい exceptionName の DOMException で拒否します。
4. document の [[orientationPendingPromise]] を null に設定します。

手順で 向きロックを適用することが OrientationLockType? orientation と Document document に対して要求された場合、 ユーザーエージェントは MUST 以下の手順を実行しなければなりません:

1. documentが完全にアクティブでなくなった場合（並列に処理している間）、かつ[[orientationPendingPromise]]の 値が nullでない場合、現在の ロックpromiseを却下してnull化する。対象はdocumentであり、 "AbortError"を用いる。
2. topDocumentをdocumentのトップレベル・トラバーサブルの アクティブな文書とする。
3. descendantDocsを順序 集合とする。この集合は、 topDocumentの子孫ナビゲーブルのアクティブな文書を、存在する場合にツリー 順で並べて構成する。
4. 各docについて、 descendantDocs内で次を実行する：
   1. docがdocumentである場合、続行する。
   2. docの[[orientationPendingPromise]] が nullである場合、続行する。
   3. 現在の ロックpromiseを却下してnull化する。対象はdocであり、 "AbortError"を用いる。
5. 次の下位手順を並列に実行する：
   1. documentが完全にアクティブでなくなっており、かつ documentの[[orientationPendingPromise]] の値が nullでない場合、現在の ロックpromiseを却下してnull化する。対象は documentであり、"AbortError"を用いて、 これらの手順を中止する。
   2. orientationがnullである場合、画面の向きのロックを解除する。
   3. そうでなければ、画面の向きをロックすることを試みる。ロックする向きは orientationとする。プラットフォームの慣例に応じて、 ビューポートの描画方法を変更し、orientationに合わせる。
   4. 以前に設定されたユーザー 設定、プラットフォームの制限、またはその他の理由によって試行が失敗した場合：
      1. 画面のアクティブな向きのロックを nullに設定する。
      2. タスクをキューに入れる。キューにはDOM操作タスク ソースを使用し、 documentの関連するグローバルオブジェクトを用いて次を実行する：
         1. documentの [[orientationPendingPromise]] がnullでない場合、 現在の ロックpromiseを却下してnull化する。対象は documentであり、"NotSupportedError"を用いる。
         2. これらの手順を中止する。
      注記

      これは、ユーザーが次のような設定を行っている場合に発生し得る。その設定は、 Webアプリケーションによる画面の向きの変更を禁止するものである。または、 ユーザーエージェントではなく基盤となるプラットフォームが、 画面の向きを指定された orientationにロックすることを許可しない場合にも発生し得る。ユーザー設定や プラットフォーム機能の違いは、 フィンガープリンティングに利用される可能性があることに注意されたい。これは、その違いによってロック 失敗の挙動に検出可能なパターンが生じる可能性があるためである。

   5. 画面のアクティブな向きの ロックを orientationに設定し、現在の向きの種類 および現在の向きの 角度を更新し、 画面の向きへの変更を反映する。
6. グローバルタスクをキューに入れる。キューにはDOM操作タスクソースを使用し、 documentの関連するグローバルオブジェクトを用いて次を実行する：
   1. promiseをdocumentの [[orientationPendingPromise]]とする。
      注記
   2. documentの[[orientationPendingPromise]] を nullに設定する。
   3. 画面の 向きの変更手順をtopDocumentに対して実行する。
   4. promiseがnullでない場合、解決する対象をpromiseとし、 値を undefinedとする。

ユーザーエージェントが トップレベル・トラバーサブル の画面の向きが変更されたと判断した場合や、ユーザーが トップレベル閲覧コンテキスト を別の画面に移動した場合は、画面の向き変更ステップを トップレベル・トラバーサブル の アクティブなドキュメント に対して実行する。

画面の向き変更ステップ（ Document document 用）は以下の通り：

1. もし document が ユーザーの注目を受けているトップレベル・トラバーサブルの完全にアクティブな子孫 でない場合は、これらの手順を中止する。
2. type および angle を画面の 現在の向きタイプおよび 現在の向き角度 とする。
3. screenOrientation を document の 関連グローバルオブジェクト の 関連付けられた ScreenOrientation とする。
4. もし type が screenOrientation の [[type]] に等しく、かつ angle が screenOrientation の [[angle]] に等しい場合、これらの手順を中止する。
5. グローバルタスクをキューに追加（ユーザー操作タスクソースに document の 関連グローバルオブジェクト を渡して）下記を実行：
   1. screenOrientationの[[angle]]を angleに設定する。
   2. screenOrientationの[[type]] を typeに設定する。
   3. イベントを発火する。イベント名は"change"、対象は screenOrientationとする。
6. descendantDocs を 順序付き集合として、 document の 子孫ナビゲーブル の アクティブなドキュメント（あれば）を木構造順に並べたものとする。
7. それぞれ doc を descendantDocs で反復し、 画面の向き変更ステップを doc で実行する。

[HTML] の「可視状態を更新する」アルゴリズムは、画面の向き変更手順を実行します。

アンロードドキュメントクリーンアップ手順 が document で実行されるとき、ユーザーエージェントは MUST 次の手順を実行しなければなりません:

1. もし document が トップレベル・トラバーサブル の アクティブなドキュメント でなければ、これらの手順を中止する。
2. 画面の向き完全ロック解除ステップを document に対して実行する。

画面の向きを完全にアンロックする手順 は、Document document に対して次の通りです:

1. もし document の [[orientationPendingPromise]] が null でなければ、 現在のロックのプロミスを拒否して無効化する（document に "AbortError"）。
2. topDocument を document の トップレベル・トラバーサブル の アクティブなドキュメント とする。
3. 向きロックを適用する： null を topDocument に適用する。

ユーザーのプライバシー保護のため、向き変更イベントの配信にはいくつかの制限が課されます：

• イベントは document が ユーザーの注目を受けているトップレベル・トラバーサブルの完全にアクティブな子孫 の場合にのみ発火します。
• 追加の 可視性状態チェックにより、隠れたドキュメントに対する防御が強化されています。
• イベントは アクティブなドキュメント（トップレベル・トラバーサブル）から起きて子孫ドキュメントに伝播します。

document が ユーザーの注目を受けているトップレベル・トラバーサブルの完全にアクティブな子孫 であることが求められるのは、 向きイベントがシステムレベルで表示され、ユーザーの注目やキーボード入力などを受けられるウィンドウのドキュメントのみがイベントを受けることを保証するためです。 追加の可視性状態チェックは多層防御となります。これらの制限により、バックグラウンドタブ、隠れウィンドウ、最小化アプリケーションがフィンガープリンティング目的で向きデータを取得できなくなります。

フィンガープリンティングに対抗するために、ユーザーエージェントは特にプライバシー重視の環境（例えばプライベートブラウズモードなど）では、以下の保護策を SHOULD 実装すべきです：

1. トップレベル・トラバーサブル の存続期間中、画面の自然な向きが [[initialType]] であるかのように動作する。
2. type ゲッターで返す値は "portrait-primary" または "landscape-primary" に制限される。画面のアスペクト比によってどちらが返されるかが決まる。
3. もし 現在の向きタイプ が [[initialType]] と一致する場合は、 angle ゲッターは 0 を返し、それ以外の場合は 90 を返す。
4. 画面の向きが変化するときは、 change イベントは 現在の向きタイプ が portrait から landscape へ、または逆にタイプが変化した場合のみ発火する。