From 7177e9130e45d6f5f2b0816b1cb8ee12eb709403 Mon Sep 17 00:00:00 2001 From: Matt Giuca Date: Fri, 1 Nov 2024 09:55:45 +1100 Subject: [PATCH 01/11] Clarify the definition of "navigation scope", "applied", and off-scope theming --- index.html | 50 ++++++++++++++++++++++++++++++-------------------- 1 file changed, 30 insertions(+), 20 deletions(-) diff --git a/index.html b/index.html index 7880b89b..7bda9fb5 100644 --- a/index.html +++ b/index.html @@ -1074,12 +1074,16 @@

If the user agent honors the value of the [=manifest/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 [^meta/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 [^meta/name^] attribute is "[^meta/name/theme-color^]". + However, the user agent SHOULD NOT override the [=default theme + color=] via an [^meta^] element whose [^meta/name^] attribute is + "theme-color" for documents that are not [=within scope=], since the + application has no control over these documents.

The user agent MAY ignore the theme color's [=alpha @@ -1779,12 +1783,23 @@

Applying the manifest

- A [=Document/processed manifest=] is applied to a top-level - browsing context, meaning that the members of the - [=Document/processed manifest=] are affecting the presentation or - behavior of a browsing context. + A [=Document/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 [=navigate|navigation=] begins.

+

A top-level browsing context that has a manifest applied to it is referred to as an application @@ -1806,11 +1821,6 @@

changed it when the application was installed.

-

- The appropriate time to apply a manifest is when the - application context is created and before - [=navigate|navigation=] to the start URL begins. -

@@ -2796,10 +2806,10 @@

The navigation scope of a manifest is the "scope" item - of a [=Document/processed manifest=]. The navigation scope restricts - the set of URLs to which an [=application context=] can be - [=navigated=] while the manifest is [=applied=]. + data-export="">navigation scope of a manifest is the + "scope" member of a [=Document/processed manifest=]. The + navigation scope governs the set of URLs to which an [=application + context=] can be [=navigated=] while the manifest is [=applied=].

From 25fc61778008baf09058dbff92fd074767ffdac6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:32:35 +1100 Subject: [PATCH 02/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 41458a08..2be78f7a 100644 --- a/index.html +++ b/index.html @@ -1077,7 +1077,7 @@

If the user agent honors the value of the [=manifest/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 + [=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 From ae9dc319761352ada10947654cb1618322b716dc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:36:05 +1100 Subject: [PATCH 03/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 2be78f7a..72f2a9dd 100644 --- a/index.html +++ b/index.html @@ -1079,7 +1079,7 @@

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 + color=] if a document whose URL is [=URL/within scope=] of the [=application context=]'s [=manifest=] includes a [^meta^] element whose [^meta/name^] attribute is "[^meta/name/theme-color^]". However, the user agent SHOULD NOT override the [=default theme From d32a33859adae26976e7fb30602d5dbca84e2a08 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:38:00 +1100 Subject: [PATCH 04/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 72f2a9dd..caa90939 100644 --- a/index.html +++ b/index.html @@ -1084,7 +1084,7 @@

whose [^meta/name^] attribute is "[^meta/name/theme-color^]". However, the user agent SHOULD NOT override the [=default theme color=] via an [^meta^] element whose [^meta/name^] attribute is - "theme-color" for documents that are not [=within scope=], since the + "theme-color" for documents' [=Document/URL=] are not [=URL/within scope=], since the application has no control over these documents.

From bc03acf7dd15c76e0227c9da8b4dfdafc4a589a1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:39:22 +1100 Subject: [PATCH 05/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index caa90939..13bc8671 100644 --- a/index.html +++ b/index.html @@ -1079,7 +1079,7 @@

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 [=URL/within scope=] of the + color=] if a [=document=] whose [=Document/URL=] is [=URL/within scope=] of the [=application context=]'s [=manifest=] includes a [^meta^] element whose [^meta/name^] attribute is "[^meta/name/theme-color^]". However, the user agent SHOULD NOT override the [=default theme From 682d48068ad3dd7e85b9c78428d8a81d7e059159 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:40:22 +1100 Subject: [PATCH 06/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 13bc8671..4282428f 100644 --- a/index.html +++ b/index.html @@ -1084,7 +1084,7 @@

whose [^meta/name^] attribute is "[^meta/name/theme-color^]". However, the user agent SHOULD NOT override the [=default theme color=] via an [^meta^] element whose [^meta/name^] attribute is - "theme-color" for documents' [=Document/URL=] are not [=URL/within scope=], since the + "theme-color" for [=documents=]' [=Document/URL=] are not [=URL/within scope=], since the application has no control over these documents.

From 72517d3f2260211cadd13bc1aa7e51e767f4e777 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:46:00 +1100 Subject: [PATCH 07/11] Update index.html Co-authored-by: Christian Liebel --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 4282428f..5f159185 100644 --- a/index.html +++ b/index.html @@ -1083,7 +1083,7 @@

[=application context=]'s [=manifest=] includes a [^meta^] element whose [^meta/name^] attribute is "[^meta/name/theme-color^]". However, the user agent SHOULD NOT override the [=default theme - color=] via an [^meta^] element whose [^meta/name^] attribute is + color=] via a [^meta^] element whose [^meta/name^] attribute is "theme-color" for [=documents=]' [=Document/URL=] are not [=URL/within scope=], since the application has no control over these documents.

From bc2951705e0cf2056e25c18fe309c32b8b4727bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:47:32 +1100 Subject: [PATCH 08/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 5f159185..41d8ac0f 100644 --- a/index.html +++ b/index.html @@ -2586,7 +2586,7 @@

The navigation scope of a manifest is the - "scope" member of a [=Document/processed manifest=]. The + "[=manifest/scope=]" member of a [=Document/processed manifest=]. The navigation scope governs the set of URLs to which an [=application context=] can be [=navigated=] while the manifest is [=applied=].

From 6f5dea7d9377ec83bda52fdd910c5e95d5bbb531 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:47:40 +1100 Subject: [PATCH 09/11] Update index.html Co-authored-by: Christian Liebel --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 41d8ac0f..0aeb13f0 100644 --- a/index.html +++ b/index.html @@ -1709,7 +1709,7 @@

A [=Document/processed manifest=] is applied to a [=top-level browsing context=], - meaning that the members of the manifest are affecting the + 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 [=navigate|navigation=] begins. From a0223849ee3bd9088603cbf4683310418a22a6d5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 7 Nov 2024 22:51:39 +1100 Subject: [PATCH 10/11] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 0aeb13f0..fba32a93 100644 --- a/index.html +++ b/index.html @@ -2587,7 +2587,7 @@

The navigation scope of a manifest is the "[=manifest/scope=]" member of a [=Document/processed manifest=]. The - navigation scope governs the set of URLs to which an [=application + navigation scope is the URLs to which an [=application context=] can be [=navigated=] while the manifest is [=applied=].

From 400e50a47ccb1134e29664ce3de0e6e1a3d08574 Mon Sep 17 00:00:00 2001 From: Marcos Caceres Date: Thu, 7 Nov 2024 23:08:12 +1100 Subject: [PATCH 11/11] Tidy and fix nav scope --- index.html | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/index.html b/index.html index fba32a93..234ab62c 100644 --- a/index.html +++ b/index.html @@ -1077,15 +1077,16 @@

If the user agent honors the value of the [=manifest/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 [=Document/URL=] is [=URL/within scope=] of the - [=application context=]'s [=manifest=] includes a [^meta^] element - whose [^meta/name^] attribute is "[^meta/name/theme-color^]". - However, the user agent SHOULD NOT override the [=default theme - color=] via a [^meta^] element whose [^meta/name^] attribute is - "theme-color" for [=documents=]' [=Document/URL=] are not [=URL/within scope=], since the - application has no control over these documents. + [=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 [=Document/URL=] is + [=URL/within scope=] of the [=application context=]'s [=manifest=] + includes a [^meta^] element whose [^meta/name^] attribute is + "[^meta/name/theme-color^]". However, the user agent SHOULD NOT + override the [=default theme color=] via a [^meta^] element whose + [^meta/name^] attribute is "theme-color" for [=documents=]' + [=Document/URL=] are not [=URL/within scope=], since the application + has no control over these documents.

The user agent MAY ignore the theme color's [=alpha @@ -1721,8 +1722,8 @@

or from a [=launching a shortcut|shortcut=], the user agent might create a new [=top-level browsing context=] with that application's [=manifest=] [=applied=], but it might not do so if the user simply - clicked a bookmark to a URL within the application's [=navigation - scope=]. + clicked a bookmark to a URL within the application's + [=manifest/navigation scope=].

A top-level browsing context that has a manifest applied to @@ -2587,8 +2588,8 @@

The navigation scope of a manifest is the "[=manifest/scope=]" member of a [=Document/processed manifest=]. The - navigation scope is the URLs to which an [=application - context=] can be [=navigated=] while the manifest is [=applied=]. + navigation scope is the URLs to which an [=application context=] can be + [=navigated=] while the manifest is [=applied=].