display_override

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

display 成员用于确定开发者首选的网站显示模式。它遵循一个过程,如果请求的显示模式不受支持,浏览器将回退到下一个显示模式。在某些高级用例中,这种回退过程可能不足够。

display_override 成员通过允许开发者提供一系列显示模式来解决此问题,浏览器在应用 display 成员之前将考虑这些模式。它的值是一个显示模式数组,按顺序考虑,并应用第一个受支持的显示模式。

显示覆盖对象是显示模式字符串,可能的值为

browser

应用程序将在传统的浏览器标签页或新窗口中打开,具体取决于浏览器和平台。这是默认设置。

fullscreen

使用所有可用的显示区域,并且不显示任何用户代理 “chrome”

minimal-ui

应用程序将看起来和感觉像一个独立的应用程序,只有最少的 UI 元素用于控制导航。这些元素会因浏览器而异。

standalone

应用程序看起来和感觉会像一个独立的应用程序。这可能包括应用程序拥有一个不同的窗口、在应用程序启动器中拥有自己的图标等。在此模式下,用户代理将排除用于控制导航的 UI 元素,但可以包含其他 UI 元素,如状态栏。

tabbed 实验性

应用程序可以在单个操作系统级窗口中包含多个应用程序上下文。支持的浏览器可以选择如何显示这些上下文,但常见的方法是提供一个标签页栏来在它们之间切换。

window-controls-overlay 实验性

此显示模式仅在应用程序位于单独的 PWA 窗口中并在桌面操作系统上时适用。应用程序将选择加入窗口控件叠加功能,其中完整的窗口表面区域可供应用的 Web 内容使用,而窗口控件按钮(最大化、最小化、关闭以及其他 PWA 特定按钮)将作为覆盖层出现在 Web 内容之上。

示例

在下面的示例中,浏览器将按以下顺序考虑显示模式回退链:fullscreenminimal-uistandalone

json
{
  "display_override": ["fullscreen", "minimal-ui"],
  "display": "standalone"
}

规范

规范
清单孵化
# display_override-member

浏览器兼容性

另见