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 的瀏覽器中載入。