Do obsługi specjalnych trybów wyświetlania aplikacje PWA mogą korzystać z właściwości „display_override”.
Plik manifestu aplikacji internetowej to plik JSON, który informuje przeglądarkę o progresywnej aplikacji internetowej i jej działaniu po zainstalowaniu na komputerze lub urządzeniu mobilnym użytkownika.
W usłudze display
możesz dostosować interfejs przeglądarki wyświetlany po uruchomieniu aplikacji. Możesz na przykład ukryć pasek adresu
i przeglądarkę Chrome. Gry można nawet tworzyć, aby uruchamiały się na pełnym ekranie.
Poniżej znajdziesz listę trybów wyświetlania określonych w momencie pisania tego artykułu.
Właściwość | Użycie |
---|---|
fullscreen |
Otwiera aplikację internetową bez interfejsu przeglądarki i zajmuje cały dostępny obszar wyświetlania. |
standalone |
Otwiera aplikację internetową tak, by wyglądała i działała jak samodzielna aplikacja. Aplikacja działa w osobnym oknie, niepowiązane z przeglądarką i ukrywa standardowe elementy interfejsu przeglądarki, takie jak pasek adresu URL. |
minimal-ui |
Ten tryb jest podobny do trybu standalone , ale udostępnia użytkownikowi minimalny zestaw elementów interfejsu służących do kontrolowania nawigacji (np. wstecz i odświeżanie).
|
browser |
Standardowa przeglądarka. |
Te tryby wyświetlania są zgodne z dobrze zdefiniowanym łańcuchem kreacji zastępczych ("fullscreen"
→ "standalone"
→ "minimal-ui"
→ "browser"
). Jeśli przeglądarka nie obsługuje danego trybu, wraca do następnego trybu wyświetlania w łańcuchu.
Wady usługi display
W przypadku takiego podłączenia przewodowego łańcucha awaryjnego występuje 3 problemy:
- Jeśli przeglądarka nie obsługuje interfejsu
"minimal-ui"
, deweloper nie może zażądać"minimal-ui"
bez konieczności ponownego włączenia trybu wyświetlania"browser"
. - Deweloperzy nie obsługują różnic między przeglądarkami, np. włączają lub wykluczają przycisk Wstecz w oknie trybu
"standalone"
. - Obecne działanie uniemożliwia wprowadzanie nowych trybów wyświetlania w sposób zgodny wstecznie, ponieważ eksploracje takie jak tryb aplikacji z kartami nie mają naturalnego miejsca w łańcuchu kreacji zastępczych.
Właściwość display_override
Te problemy rozwiązuje właściwość display_override
, którą przeglądarka uważa przed właściwością display
. Jego wartość to sekwencja ciągów tekstowych uznawanych za w kolejności. Zostanie zastosowany pierwszy obsługiwany tryb wyświetlania. Jeśli żadna z tych opcji nie jest obsługiwana, przeglądarka zwraca pole display
.
W poniższym przykładzie łańcuch zastępowania trybu wyświetlania będzie wyglądać tak.
(Szczegółowe informacje o grupie "window-controls-overlay"
nie są uwzględnione w tym artykule).
"window-controls-overlay"
(Najpierw spójrz nadisplay_override
)."minimal-ui"
"standalone"
(Gdy zasóbdisplay_override
jest wyczerpany, oceń wartośćdisplay
)."minimal-ui"
(na koniec użyj łańcucha kreacji zastępczychdisplay
)."browser"
{
"display_override": ["window-controls-overlay", "minimal-ui"],
"display": "standalone",
}
Aby zachować zgodność wsteczną, każdy kolejny tryb wyświetlania będzie akceptowalny jako wartość display_override
, ale nie display
.
Przeglądarki, które nie obsługują display_override
, wracają do właściwości display
i ignorują display_override
jako nieznaną właściwość manifestu aplikacji internetowej.
Przydatne linki
- Wyjaśnienie
- Zamiar wysłania wątku
- Błąd Chromium
- Wpis o stanie Chrome
- Repozytorium inkubacji plików manifestu
Poświadczenia
Właściwość display_override
została sformalizowane przez Daniela Murphy'ego.