WindowControlsOverlay

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

WindowControlsOverlay 介面是 Window Controls Overlay API 的一部分,它提供了桌面漸進式 Web 應用(PWA)中標題欄區域幾何圖形的資訊,以及在標題欄區域幾何圖形發生變化時通知的事件。該介面可以透過 Navigator.windowControlsOverlay 訪問。

EventTarget WindowControlsOverlay

例項屬性

WindowControlsOverlay.visible 只讀 實驗性

一個 布林值,指示視窗控制元件覆蓋層是否可見。

例項方法

WindowControlsOverlay.getTitlebarAreaRect() 實驗性

返回標題欄的大小和位置。

事件

使用 EventTarget.addEventListener() 或透過為該介面相關的 oneventname 屬性分配事件監聽器來監聽這些事件。

geometrychange 實驗性

當標題欄區域的幾何圖形發生變化時觸發。

示例

js
if ("windowControlsOverlay" in navigator) {
  navigator.windowControlsOverlay.addEventListener(
    "geometrychange",
    (event) => {
      if (event.visible) {
        const rect = event.titlebarAreaRect;
        // Do something with the coordinates of the title bar area.
      }
    },
  );
}

規範

規範
視窗控制元件覆蓋
# windowcontrolsoverlay-interface

瀏覽器相容性