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

浏览器兼容性