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

瀏覽器相容性

另見