From 0153346d277ed135708e14229a55842579a00c54 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 12:09:54 +0000 Subject: [PATCH] clarify the definition of "navigation scope", "applied", and off-scope theming (#1151) SHA: ec8a23b832f106517a6e03cadc8b5efee923b0cb Reason: push, by marcoscaceres Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- index.html | 356 ++++++++++++++++++++++++++++++----------------------- 1 file changed, 204 insertions(+), 152 deletions(-) diff --git a/index.html b/index.html index de20301f..fedbc133 100644 --- a/index.html +++ b/index.html @@ -163,7 +163,7 @@ .mdn .samsunginternet_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/samsung-internet/samsung-internet.svg)} .mdn .webview_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/android-webview/android-webview.png)} - + @@ -808,7 +808,7 @@

Web Application Manifest

The scope member tells the browser which documents are part of a web application, and which are not - and hence, to which - set of web pages the manifest is "applied" when the user + set of web pages the manifest is "applied" when the user navigates around a web site.

@@ -823,7 +823,7 @@

Web Application Manifest

Navigation scope for the technical details.

- Applying a manifest means that any members that affect + Applying a manifest means that any members that affect presentation found in the manifest will come into effect, such as display "fullscreen", or applying a particular screen orientation. As long as the application is navigated to URLs that are @@ -1866,12 +1866,16 @@

Web Application Manifest

If the user agent honors the value of the theme_color - member as the default theme color, then that color serves as - the theme color for all browsing contexts to which the - manifest is applied. However, a document may override the - default theme color through the inclusion of a valid [HTML] - meta element whose name attribute value is - "theme-color". + member as the default theme color, then that color serves as the + theme color for all browsing contexts to which the manifest + is applied. However, the user agent MAY override the default theme color if a document whose URL is + within scope of the application context's manifest + includes a meta element whose name attribute is + "theme-color". However, the user agent SHOULD NOT + override the default theme color via a meta element whose + name attribute is "theme-color" for documents' + URL are not within scope, since the application + has no control over these documents.

The user agent MAY ignore the theme color's alpha component based on the context. For example, in most environments, @@ -1934,7 +1938,7 @@

Web Application Manifest

- The manifest's background_color member describes the + The manifest's background_color member describes the expected background color of the web application. It repeats what is already available in the application stylesheet but can be used by the user agent to draw the background color of a web @@ -2005,7 +2009,7 @@

Web Application Manifest

- The manifest's shortcuts member is an list of + The manifest's shortcuts member is an list of shortcut items that provide access to key tasks within a web application.

@@ -2067,8 +2071,8 @@

Web Application Manifest

- A localizable member is a manifest member that can be - localized. Each localizable member of the manifest has a + A localizable member is a manifest member that can be + localized. Each localizable member of the manifest has a corresponding *_localized member, where * represents the member name.

@@ -2148,7 +2152,7 @@

Web Application Manifest

When a string is used, or when the dir - member of the localized text object is missing, the default direction (dir member of the manifest) is + member of the localized text object is missing, the default direction (dir member of the manifest) is applied.

Note

- A processed manifest is applied to a top-level - browsing context, meaning that the members of the - processed manifest are affecting the presentation or - behavior of a browsing context. + A processed manifest is applied to a top-level browsing context, + meaning that the members of the manifest are affecting the + presentation and/or behavior of the browsing context. Whenever a + top-level browsing context is created, the user agent MAY + apply a manifest to it before navigation begins.

+
Note

- A top-level browsing context that has a manifest applied to + A top-level browsing context that has a manifest applied to it is referred to as an application context.

- If an application context is created as a result of the user - agent being asked to navigate to a deep link, the - user agent MUST immediately navigate to the deep link + If an application context is created as a result of the user + agent being asked to navigate to a deep link, the + user agent MUST immediately navigate to the deep link with historyHandling set to "replace". Otherwise, when - the application context is created, the user agent MUST - immediately navigate to the start URL with + the application context is created, the user agent MUST + immediately navigate to the start URL with historyHandling set to "replace".

-
Note