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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅