デバイスポスチャAPI

デバイスポスチャとは、デバイスが保持する物理的な姿勢であり、角度に加えてセンサーなどから得られる情報に基づく場合もあります。近年、ポスチャを変化できる機能を持つ新しいタイプのモバイルデバイスが登場しています。最も一般的なのは、画面自体や画面周囲を折り畳めるデバイスであり、物理的な形状を変更できます。デバイスのポスチャを知る主な目的は、レスポンシブデザインによる新しいユーザー体験を可能にすることです。

「折り畳み」デバイスには主に2つの物理的なフォームファクターがあります。1つは1枚の柔軟な画面（シームレス）を持つもの、もう1つは2枚の画面（シームあり）を持つものです。どちらもヒンジ周辺で折り畳みでき、現行仕様は両方のタイプに適用されます。また、シームレス・シームありの両方とも、モバイルやタブレットからラップトップサイズまで様々な寸法があります。さらに、デバイスによってデフォルトの向き（縦向き・横向き）が異なり、折り畳みも縦方向・横方向のいずれかの場合があります。

ウェブサイトの使い勝手を折り目部分を避けて向上させたり、Webで新しいユースケースを実現したりするために、デバイスポスチャを知ることで開発者は各種デバイスに合わせたコンテンツを調整できます。

デバイスが完全に平らでない状態でも、コンテンツは利用・閲覧できます。この場合、開発者はデバイスポスチャの状態に応じて異なるレイアウトを提供したいと考えるかもしれません。

以下の内部スロットが Document インターフェースに追加されます。

[HTML]仕様は Navigator インターフェースを定義していますが、 本仕様はこれを拡張します:

WebIDL[SecureContext, Exposed=(Window)]
partial interface Navigator {
  [SameObject] readonly attribute DevicePosture devicePosture;
};

WebIDL[SecureContext, Exposed=(Window)]
interface DevicePosture : EventTarget {
  readonly attribute DevicePostureType type;
  attribute EventHandler onchange;
};

enum DevicePostureType {
  "continuous",
  "folded"      
};

この仕様では以下のポスチャ値を定義します：

1. 

   Continuous ポスチャ：Continuousポスチャは 「平らな」状態を指します。これは、異なるポスチャを持たないほとんどのデバイスのデフォルトの状態です。

   折り目やヒンジ、類似の機能を持たないデバイスも含まれます。

   ハードウェア革新の性質上、デュアル・折り畳み・ロール・カーブ画面なども、Documentが平坦なレイアウトで表示される姿勢であれば含まれます。

   例：

   • 折り畳みデバイスが平らに完全展開された姿勢
   • 折り畳みデバイスで、ブラウザがヒンジをまたがないウィンドウ/セクションで動作している
   • 2-in-1デバイスがタブレットモードで片面のみ使用している場合
   • 折り畳めないデバイス
   注

   デバイスによっては、物理的には平らでない姿勢で複数アプリが動作していても、ブラウザが複数画面・セクションにまたがっていなければ、そのポスチャはcontinuousとなります。

2. Folded ポスチャ：Foldedポスチャは物理的に折り畳み可能なデバイスを指します。これらのデバイスは柔軟な1枚画面または2枚隣接画面を持つことができます。この姿勢ではディスプレイ/セクション間に「平ら」状態を超えない角度が形成されます。

   例：

   • 折り畳みデバイスが垂直ヒンジで内部画面を「本」姿勢で使用し、内容が両セクションにまたがり、約30°〜170°の角度を形成する場合
   • 折り畳みデバイスが水平ヒンジで「ラップトップ」姿勢で使用されている場合
   注

   折り畳みデバイスが半分折りたたまれた状態（本のような状態）で使われる場合、実装者はテキスト方向や書字モードがレイアウトや表示に与える影響を考慮する必要があります。

   例えば、右から左へ書く言語（アラビア語、ヘブライ語、シリア語など）や、多くの縦書きモード（東アジア言語など）では、英語の本とは逆の順序でページが進み、ページ番号の小さい方が右側になります。

   詳細は 中国語、 日本語、韓国語 の書字モードの違いを参照してください。

API上、ポスチャ値は DevicePostureType 列挙値で表されます。

すべての Document インスタンスは内部スロット [[CurrentPosture]] を持ち、これは Document の作成時に初期化されるべきですが、そうでない場合は初めてアクセスされた時点、値が読み取られる前にMUST初期化される必要があります。ユーザーエージェントはMUST、デバイスポスチャ変更手順を、documentをその Document に設定し、disallowRecursion を true にして初期化する必要があります。

指定の Document において、現在のポスチャは現在のヒンジ角度と 画面の向き、その他実装依存のシグナルから導出されます。

以下の表は規範的ではありません。

本仕様に関して新たなセキュリティ考慮事項は報告されていません。ただし、文書内で示されている 10. プライバシーに関する考慮事項 を確認することが推奨されます。

1. 折り目・ヒンジ部分にコンテンツ（特にボタン）を配置しないよう設計・実装すること。この部分は曲面のため指での操作が困難または不可能な場合があります。
2. 折り畳み時に、動画や画像など大きな連続コンテンツを折り目・ヒンジ部分にまたがって配置しないよう設計・実装すること。この部分はコンテンツや色が少し歪みます。
3. 画面スペースをより有効活用するため、分割UI（画面セグメントごとにコンテンツを分割表示するUI）を採用し、より強力で差別化されたインターフェースを提供すること。

• UI要素の配置： ダイアログの一般的な配置は水平・垂直中央ですが、左右対称の折り畳みデバイスでは折り目中央に配置されてしまい、ボタンの操作やテキストの読み取りが困難になります。
• フルスクリーンモード： フルスクリーンで要素をリサイズする際、通常は Window の幅・高さへ拡大しますが、 折り畳み時は要素が折り目をまたいで配置され、ユーザー体験が損なわれます。代わりに、折り目の上または下に要素を表示する方法が考えられます。
• ユーザー体験の向上： このAPIにより、デバイス折り畳み時に異なる体験を提供でき、アクセシビリティも向上します。例として、動画視聴時に折り畳み状態なら動画を上部、コメント欄を下部に配置する、テレビ会議アプリなら映像を上部、チャットを下部に表示する等。
• 特定のポスチャのみを想定したコンテンツ設計は避ける： 折り畳みデバイスの特徴は柔軟性・可変性です。orientationと同様、常にユーザーの選択を優先すべきで、UIを選べるようにするのが理想です。
• 支援技術向けのコンテンツ通知： ARIAライブリージョンを活用し、レイアウト変更など重要な変更を動的に通知してください。例えば、折り畳みにより動画プレイヤーが上部、コメントが下部に移動した場合、「動画プレイヤーが上画面へ移動、コメントが折り目の下へ移動」などと通知することで利用者の利便性が向上します。
• 支援技術との互換性： 様々な支援技術で十分な動作確認を行い、ポスチャ変化時に正しく通知・互換性が確保されていることを確認してください。

Device Posture APIは、インターフェースの完全な検証に物理的なハードウェアデバイスが必要となるため、テスト著者にとって課題となります。この課題への対応として、本書では [WEBDRIVER2] の 拡張コマンド を定義し、ユーザーが報告されるデバイスポスチャを制御し、実際のデバイスをシミュレートできるようにしています。

以下の 拡張コマンドと 8. アルゴリズム との統合をサポートするため、top-level traversable は以下の内部スロットを持つ必要があります：

非規範的と記載されたセクションのほか、著者ガイドライン・図・例・注記はすべて非規範的です。それ以外は規範的です。

この文書の MUST および SHOULD のキーワードは、 BCP 14 [RFC2119] [RFC8174] に記載されている通り、ここで示したように全て大文字で現れる場合のみ解釈されます。

本仕様は、含まれているインターフェースを実装する ユーザーエージェントという単一の製品に対する適合基準を定義します。