WindowControlsOverlay

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中可用。

实验性：这是一个实验性技术
在生产环境中使用之前，请仔细查看浏览器兼容性表。

的WindowControlsOverlay接口窗口控件叠加层 API公开有关桌面渐进式 Web 应用中标题栏区域几何形状的信息，以及一个事件，用于了解它何时发生变化。此接口可从Navigator.windowControlsOverlay访问。

实例属性

WindowControlsOverlay.visible 只读实验性: 一个布尔值，指示窗口控件叠加层是可见还是不可见。

实例方法

WindowControlsOverlay.getTitlebarAreaRect() 实验性: 返回标题栏的大小和位置。

事件

使用EventTarget.addEventListener()或通过将事件侦听器分配给此接口的相关oneventname属性来侦听这些事件。

geometrychange 实验性: 标题栏区域几何形状发生变化时触发。

示例

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

浏览器兼容性

BCD 表格仅在浏览器中加载