Navigator:windowControlsOverlay 属性

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

Navigator 接口的 windowControlsOverlay 只读属性返回 WindowControlsOverlay 接口,该接口提供有关使用了窗口控件叠加层 API 的桌面渐进式 Web 应用程序的标题栏几何图形的信息。

安装在桌面操作系统上的渐进式 Web 应用程序可以通过在 Web 应用程序清单成员 display_override 中使用 window-controls-overlay 值来选择加入窗口控件叠加层特性。

这样做会隐藏默认的窗口标题栏,并使应用程序可以访问应用程序窗口的整个区域。

一个 WindowControlsOverlay 接口。

示例

js
if ("windowControlsOverlay" in navigator) {
  const rect = navigator.windowControlsOverlay.getTitlebarAreaRect();
  // 对标题栏矩形区域做一些处理。
} else {
  // 窗口控件叠加层特性不可用。
}

规范

Specification
Window Controls Overlay
# windowcontrolsoverlay-interface

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
windowControlsOverlay

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.