Skip to content

Commit 7177e91

Browse files
mgiucamarcoscaceres
authored andcommitted
Clarify the definition of "navigation scope", "applied", and off-scope theming
1 parent 22b2259 commit 7177e91

File tree

1 file changed

+30
-20
lines changed

1 file changed

+30
-20
lines changed

index.html

+30-20
Original file line numberDiff line numberDiff line change
@@ -1074,12 +1074,16 @@ <h3>
10741074
</p>
10751075
<p>
10761076
If the user agent honors the value of the [=manifest/theme_color=]
1077-
member as the <a>default theme color</a>, then that color serves as
1078-
the <a>theme color</a> for all browsing contexts to which the
1079-
manifest is <a>applied</a>. However, a document may override the
1080-
<a>default theme color</a> through the inclusion of a valid [[HTML]]
1081-
[^meta^] element whose [^meta/name^] attribute value is
1082-
`"theme-color"`.
1077+
member as the [=default theme color=], then that color serves as the
1078+
[=theme color=] for all browsing contexts to which the manifest is
1079+
[=applied=]. However, the user agent MAY override the [=default theme
1080+
color=] if a document whose URL is [=within scope=] of the
1081+
[=application context=]'s [=manifest=] includes a [^meta^] element
1082+
whose [^meta/name^] attribute is "[^meta/name/theme-color^]".
1083+
However, the user agent SHOULD NOT override the [=default theme
1084+
color=] via an [^meta^] element whose [^meta/name^] attribute is
1085+
"theme-color" for documents that are not [=within scope=], since the
1086+
application has no control over these documents.
10831087
</p>
10841088
<p data-cite="CSS-COLOR-4">
10851089
The user agent MAY ignore the <a>theme color</a>'s [=alpha
@@ -1779,12 +1783,23 @@ <h3 id="applying">
17791783
Applying the manifest
17801784
</h3>
17811785
<p>
1782-
A [=Document/processed manifest=] is <dfn data-export=""
1783-
data-local-lt="apply|applying">applied</dfn> to a <a>top-level
1784-
browsing context</a>, meaning that the members of the
1785-
[=Document/processed manifest=] are affecting the presentation or
1786-
behavior of a browsing context.
1786+
A [=Document/processed manifest=] is <dfn data-lt=
1787+
"apply|applying">applied</dfn> to a [=top-level browsing context=],
1788+
meaning that the members of the <a>manifest</a> are affecting the
1789+
presentation and/or behavior of the browsing context. Whenever a
1790+
[=top-level browsing context=] is created, the user agent MAY
1791+
[=apply=] a manifest to it before [=navigate|navigation=] begins.
17871792
</p>
1793+
<aside class="note">
1794+
Whether to [=apply=] a manifest, and which manifest to apply, is at
1795+
the discretion of the user agent, based on the user's actions. For
1796+
example, if the user launched an application from the system menu
1797+
or from a [=launching a shortcut|shortcut=], the user agent might
1798+
create a new [=top-level browsing context=] with that application's
1799+
[=manifest=] [=applied=], but it might not do so if the user simply
1800+
clicked a bookmark to a URL within the application's [=navigation
1801+
scope=].
1802+
</aside>
17881803
<p>
17891804
A <a>top-level browsing context</a> that has a manifest applied to
17901805
it is referred to as an <dfn data-export="">application
@@ -1806,11 +1821,6 @@ <h3 id="applying">
18061821
changed it when the application was <a>installed</a>.
18071822
</p>
18081823
</aside>
1809-
<p>
1810-
The appropriate time to <a>apply</a> a manifest is when the
1811-
<a>application context</a> is created and before
1812-
[=navigate|navigation=] to the <a>start URL</a> begins.
1813-
</p>
18141824
</section>
18151825
<section id="updating">
18161826
<h3>
@@ -2796,10 +2806,10 @@ <h2>
27962806
</h2>
27972807
<p>
27982808
The <dfn data-dfn-for="manifest" data-lt="navigation scope"
2799-
data-export="">navigation scope of a manifest</dfn> is the "scope" item
2800-
of a [=Document/processed manifest=]. The navigation scope restricts
2801-
the set of URLs to which an [=application context=] can be
2802-
[=navigated=] while the manifest is [=applied=].
2809+
data-export="">navigation scope of a manifest</dfn> is the
2810+
"<a>scope</a>" member of a [=Document/processed manifest=]. The
2811+
navigation scope governs the set of URLs to which an [=application
2812+
context=] can be [=navigated=] while the manifest is [=applied=].
28032813
</p>
28042814
<div class="note">
28052815
<p>

0 commit comments

Comments
 (0)