Navigator: windowControlsOverlay プロパティ

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

windowControlsOverlay は Navigator インターフェイスの読み取り専用プロパティで、WindowControlsOverlay インターフェイスを返します。このインターフェイスは、ウィンドウ制御オーバーレイ API を使用するデスクトップのプログレッシブウェブアプリのタイトルバーの形状に関する情報を公開します。

デスクトップのオペレーティングシステムにインストールされたプログレッシブウェブアプリは、ウェブアプリマニフェストのメンバーの display_override で window-controls-overlay 値を使用することで、ウィンドウ制御オーバーレイ機能を有効にすることができます。

そうすることで、既定のウィンドウタイトルバーが非表示になり、アプリがアプリウィンドウの全領域にアクセスできるようになります。

値

WindowControlsOverlay インターフェイスです。

例

js
if ("windowControlsOverlay" in navigator) {
  const rect = navigator.windowControlsOverlay.getTitlebarAreaRect();
  // タイトルバーの領域の長方形に対して何かをする。
} else {
  // ウィンドウ制御オーバーレイ機能が利用できない。
}