display_override
类型 | 数组 |
---|
该display
成员用于确定开发者对网站的首选显示模式。它遵循一个流程,如果请求的显示模式不受支持,则浏览器将回退到下一个显示模式。在某些高级用例中,此回退流程可能不够。
该display_override
成员通过允许开发者提供浏览器在使用display
成员之前要考虑的显示模式序列来解决此问题。其值是一个按顺序考虑的显示模式数组,并应用第一个受支持的显示模式。
值
显示覆盖对象是显示模式字符串,可能的值为
显示模式 | 描述 |
---|---|
browser |
应用程序在传统的浏览器选项卡或新窗口中打开,具体取决于浏览器和平台。这是默认设置。 |
fullscreen |
使用所有可用的显示区域,并且不显示用户代理Chrome。 |
minimal-ui |
应用程序的外观和感觉将像一个独立的应用程序,并具有一组最少的用于控制导航的 UI 元素。元素会因浏览器而异。 |
standalone |
应用程序的外观和感觉将像一个独立的应用程序。这可能包括应用程序具有不同的窗口、在应用程序启动器中拥有自己的图标等。在此模式下,用户代理将排除用于控制导航的 UI 元素,但可以包含其他 UI 元素,例如状态栏。 |
tabbed |
应用程序可以在单个操作系统级窗口内包含多个应用程序上下文。支持的浏览器可以选择如何显示这些上下文,但常见的方法是提供一个选项卡栏来在它们之间切换。 |
window-controls-overlay |
此显示模式仅在应用程序位于单独的 PWA 窗口中且位于桌面操作系统上时适用。应用程序将选择加入窗口控件叠加功能,其中完整的窗口表面积将可用于应用程序的 Web 内容,并且窗口控制按钮(最大化、最小化、关闭和其他 PWA 特定的按钮)将显示为 Web 内容之上的叠加层。 |
示例
在下面的示例中,浏览器将按以下顺序考虑以下显示模式回退链:fullscreen
→ minimal-ui
→ standalone
。
json
{
"display_override": ["fullscreen", "minimal-ui"],
"display": "standalone"
}
规范
规范 |
---|
清单孵化器 # display_override-member |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。