この文書は、Web開発者がデスクトップ環境で実行されているインストール済みWebアプリケーションのタイトルバー領域を制御できる一連の技術を規定しています。これらの技術は (WCO) として知られています。

本ドラフトは、WCOおよびそれで説明されている技術の標準化プロセスの出発点として意図されたものです。記載されている技術は、他のワーキンググループの別仕様に移動される可能性があります。

概念

• ウィンドウコントロールオーバーレイ：非モバイル環境で実行されるインストール済みWebアプリケーション向けの機能で、JSやCSSを用いて[=title bar area=]上にビューポートを拡張できるようにします。
• タイトルバー領域：WCOが有効な場合、これはタイトルバーが占めるウィンドウフレーム上の領域で、[=controls of the window=]を格納する[=overlay=]に該当する領域は含まれません。
• ウィンドウコントロール： OSが各アプリケーションで一貫して使用するインターフェース要素で、ユーザーがアプリケーションを制御する特定の操作を実行できるようにします。[=window controls=] の典型的な操作には最小化、最大化／復元、閉じるボタンなどが含まれます。
• オーバーレイ of [=window controls=]： [=window controls=] を格納し、ビューポート上に重ねて表示される領域です。

`Navigator`インターフェースの拡張

[[HTML]] 仕様は Navigator インターフェースを定義しており、本仕様ではこれを拡張します：

        [SecureContext, Exposed=(Window)]
        partial interface Navigator {
          [SameObject] readonly attribute WindowControlsOverlay windowControlsOverlay;
        };
      

`Window`インターフェースの拡張

WindowControlsOverlay インターフェース

        [Exposed=Window]
        interface WindowControlsOverlay : EventTarget {
          readonly attribute boolean visible;
          DOMRect getTitlebarAreaRect();
          attribute EventHandler ongeometrychange;
        };

        [Exposed=Window]
        interface WindowControlsOverlayGeometryChangeEvent : Event {
          constructor(DOMString type, WindowControlsOverlayGeometryChangeEventInit eventInitDict);
          [SameObject] readonly attribute DOMRect titlebarAreaRect;
          readonly attribute boolean visible;
        };

        dictionary WindowControlsOverlayGeometryChangeEventInit : EventInit {
          required DOMRect titlebarAreaRect;
          boolean visible = false;
        };
      

getTitlebarAreaRect メソッド

`getTitlebarAreaRect()` メソッドは、Webコンテンツが表示可能な利用可能領域を表すDOMRectを返します。このタイトルバー領域は[=window controls=] [=overlay=]の下部領域は含みません。

新しい [=display mode/window-controls-overlay=] [=display mode=] の追加

本仕様は次の[=display mode=]を定義します：

window-controls-overlay

Webアプリケーションは、ネイティブOSのウィンドウコントロールは表示したまま、Webコンテンツをタイトルバー領域まで拡張して表示できます。また、Webコンテンツ内に[=draggable region=] を指定し、カスタムタイトルバーを作成することも可能です。

[=display mode/window-controls-overlay=] [=display mode=] はmanifestの [=manifest/display_override=] メンバーで指定できます。

タイトルバー領域用環境変数

CSSOMとの統合

本仕様は [[cssom-view]] 仕様と連携し、以下のアルゴリズム を修正します：

ビューポートで[=Window/resize=] アルゴリズムを実行する際、ステップ1の後に [=resize the title bar area=] を実行します。

アルゴリズム

セキュリティとプライバシーに関する考慮事項