@@ -1074,12 +1074,16 @@ <h3>
1074
1074
</ p >
1075
1075
< p >
1076
1076
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.
1083
1087
</ p >
1084
1088
< p data-cite ="CSS-COLOR-4 ">
1085
1089
The user agent MAY ignore the < a > theme color</ a > 's [=alpha
@@ -1779,12 +1783,23 @@ <h3 id="applying">
1779
1783
Applying the manifest
1780
1784
</ h3 >
1781
1785
< 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.
1787
1792
</ 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 >
1788
1803
< p >
1789
1804
A < a > top-level browsing context</ a > that has a manifest applied to
1790
1805
it is referred to as an < dfn data-export =""> application
@@ -1806,11 +1821,6 @@ <h3 id="applying">
1806
1821
changed it when the application was < a > installed</ a > .
1807
1822
</ p >
1808
1823
</ 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 >
1814
1824
</ section >
1815
1825
< section id ="updating ">
1816
1826
< h3 >
@@ -2796,10 +2806,10 @@ <h2>
2796
2806
</ h2 >
2797
2807
< p >
2798
2808
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=].
2803
2813
</ p >
2804
2814
< div class ="note ">
2805
2815
< p >
0 commit comments