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 |
浏览器兼容性
加载中…