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

另請參閱