WindowControlsOverlayGeometryChangeEvent

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

WindowControlsOverlayGeometryChangeEvent 接口是 Window Controls Overlay API 的一部分,当桌面 PWA 的标题栏区域的大小或可见性发生变化时,它会被传递给 geometrychange 事件。

Event WindowControlsOverlayGeometryChangeEvent

构造函数

WindowControlsOverlayGeometryChangeEvent() 实验性

使用给定的参数创建一个 WindowControlsOverlayGeometryChangeEvent 事件。

实例属性

也继承自其父级 Event 的属性.

WindowControlsOverlayGeometryChangeEvent.titlebarAreaRect 只读 实验性

一个 DOMRect 对象,表示标题栏区域的位置和大小。

WindowControlsOverlayGeometryChangeEvent.visible 只读 实验性

一个 布尔值,指示窗口控件覆盖层是否可见。

示例

下面的示例展示了如何通过在 Navigator.windowControlsOverlay 属性上添加事件处理程序来使用 WindowControlsOverlayGeometryChangeEvent 实例,以监听 PWA 标题栏区域的几何形状变化。

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

浏览器兼容性

另见