画面の向き

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

Any

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

Default（アンロック時）

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

Landscape

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

Natural

ユーザーエージェント、ユーザー、オペレーティングシステム、または画面自体によって決定されるデバイスディスプレイにとって最も自然な向きです。例えば、ユーザーの手でデバイスを立てて持ち、画面がユーザーに向いている状態です。コンピュータモニターは一般的に landscape-primary が自然な向きですが、携帯電話は多くの場合 portrait-primary が自然な向きです。

Portrait

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

Primary

デバイスの画面の自然な向き（portrait または landscape のいずれか）です。

Secondary

デバイスの画面のprimary向きとは逆の portrait または landscape です。

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

アクティブな向きロック

画面がロックされている画面の向き（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 でない場合は、現在のロックのプロミスを拒否して無効化する（document に "AbortError" を指定）。
2. topDocument を document の トップレベル・トラバーサブル の アクティブなドキュメント とする。
3. descendantDocs を、順序付き集合 で、 topDocument の 子孫ナビゲーブル の アクティブなドキュメントを木構造順に並べたものとする。
4. それぞれ doc を descendantDocs の中で反復する：
   1. もし doc が document であれば、スキップする。
   2. もし doc の [[orientationPendingPromise]] が null であれば、スキップする。
   3. 現在のロックのプロミスを拒否して無効化する（doc に "AbortError" を指定）。
5. 次のサブステップを 並列処理中に実行する：
   1. もし document が 完全にアクティブ でなくなり、 document の [[orientationPendingPromise]] が null でなければ、現在のロックのプロミスを拒否して無効化する（document に "AbortError" を指定）、これ以降の手順を中止する。
   2. もし orientation が null なら、画面の向きをロック解除する。
   3. それ以外の場合、プラットフォームの慣習に従い、orientation に画面の向きをロックしようと試み、ビューポートの描画方法を orientation に合わせて変更する。
   4. もしこの試行がユーザーによる設定済みの制限、プラットフォームの仕様、その他の理由で失敗した場合：
      1. 画面の 有効な向きロック を null に設定する。
      2. タスクをキューに追加する（DOM操作タスクソースに、 document の 関連グローバルオブジェクト を渡して）：
         1. もし document の [[orientationPendingPromise]] が null でなければ、 現在のロックのプロミスを拒否して無効化する（document に "NotSupportedError" を指定）。
         2. これ以降の手順を中止する。
      Note

      これは、ユーザーがスクリーンの向き変更をウェブアプリケーションから防ぐように設定している場合や、 ユーザーエージェントではなくプラットフォーム自体が指定した向きへの画面ロックを許可しない場合に発生します。 ユーザー設定や端末機能による違いがロック失敗の傾向に現れるため、フィンガープリンティングに利用される可能性がある点にも注意が必要です。

   5. 画面の 有効な向きロック を orientation に設定し、 現在の向きタイプ と 現在の向き角度 を画面の向きの変更を反映するように更新する。
6. グローバルタスクをキューに追加する（DOM操作タスクソースに、 document の 関連グローバルオブジェクト を渡して）：
   1. promise を document の [[orientationPendingPromise]] とする。
      Note
   2. document の [[orientationPendingPromise]] を null に設定する。
   3. 画面の向き変更ステップ を topDocument で実行する。
   4. もし promise が null でなければ、 resolve で 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 へ、または逆にタイプが変化した場合のみ発火する。