WindowControlsOverlay:geometrychange 事件

可用性有限

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

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

當漸進式 Web 應用的標題欄區域的位置、大小或可見性發生變化時,會觸發 geometrychange 事件。

這僅適用於安裝在桌面作業系統上的漸進式 Web 應用,並且使用了 視窗控制元件覆蓋 API

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("geometrychange", (event) => { })

ongeometrychange = (event) => { }

事件型別

一個 WindowControlsOverlayGeometryChangeEvent。繼承自 Event

Event WindowControlsOverlayGeometryChangeEvent

事件屬性

除了下面列出的屬性之外,父介面 Event 的屬性也可使用。

titlebarAreaRect

一個 DOMRect,表示應用內容中標題欄區域的位置和大小。

visible

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

示例

使用 addEventListener()

js
navigator.windowControlsOverlay.addEventListener("geometrychange", (event) => {
  const { x, y, width, height } = event.titlebarAreaRect;
  console.log(
    `The titlebar area coordinates are x:${x}, y:${y}, width:${width}, height:${height}`,
  );
});

使用 ongeometrychange 事件處理程式屬性

js
navigator.windowControlsOverlay.ongeometrychange = (event) => {
  const { x, y, width, height } = event.titlebarAreaRect;
  console.log(
    `The titlebar area coordinates are x:${x}, y:${y}, width:${width}, height:${height}`,
  );
};

規範

規範
視窗控制元件覆蓋
# the-ongeometrychange-attribute

瀏覽器相容性