@@ -1823,24 +1823,32 @@ <h2>
18231823 Manifest image resources
18241824 </ h2 >
18251825 < p >
1826- Each < dfn > manifest image resource</ dfn > is an [=image resource=] that
1827- is conceptually part of a web application, suitable to use in various
1828- contexts depending on the semantics of the member that is using the
1829- object (e.g., an icon that is part of an application menu, etc.).
1826+ Each < dfn > manifest image resource</ dfn > is an [=image resource=]. The
1827+ context in which an manifest image resource is presented is determnined
1828+ by the semantics of the associated manifest member (e.g., an
1829+ [=manifest/icons=] member is generally used to represent the
1830+ application icon).
18301831 </ p >
18311832 < p >
18321833 A [=manifest image resource=] differs from a [=image resource=] in that
18331834 it can have an additional [=manifest image resource/purpose=] member.
18341835 </ p >
18351836 < p >
1836- User agents MAY modify the images associated with an [=manifest image
1837- resource=] to better match the platform’ s visual style before
1837+ User agents MAY modify the images associated with a [=manifest image
1838+ resource=] to better match the platform' s visual style before
18381839 displaying it to the user, for example by rounding the corners or
18391840 painting it in a specific color. It is recommended that developers
18401841 prepare their image resources for such scenarios to avoid losing
18411842 important information through, e.g., change of color or clipped
18421843 corners.
18431844 </ p >
1845+ < p >
1846+ User agents MAY [=fetch=] an [=manifest image resource=] by running the
1847+ [=fetching an image resource=] algorithm. Alternatively, the user agent
1848+ MAY delegate [=fetch|fetching=] [=manifest image resources=] to the
1849+ underlying platform. How the underlying platform fetches a manifest
1850+ image resource is outside the scope of this specification.
1851+ </ p >
18441852 < section >
18451853 < h3 >
18461854 `purpose` member
@@ -1946,53 +1954,6 @@ <h3>
19461954 </ li >
19471955 </ ol >
19481956 </ section >
1949- < section >
1950- < h3 >
1951- Content security policy
1952- </ h3 >
1953- < p >
1954- The security policy that governs whether a < a > user agent</ a > can
1955- fetch an icon image is governed by the `img-src` directive [[CSP3]]
1956- associated with the manifest's owner {{Document}}.
1957- </ p >
1958- < aside class ="example " title ="Content security policy of icons ">
1959- < p >
1960- For example, given the following `img-src` directive in the
1961- `Content-Security-Policy` HTTP header of the manifest's owner
1962- {{Document}}:
1963- </ p >
1964- < pre class ="http ">
1965- HTTP/1.1 200 OK
1966- Content-Type: text/html
1967- Content-Security-Policy: img-src icons.example.com
1968-
1969- <!doctype>
1970- <html>
1971- <link rel="manifest" href="manifest.webmanifest">
1972- </ pre >
1973- < p >
1974- And given the following `manifest.webmanifest`:
1975- </ p >
1976- < pre class ="json ">
1977- {
1978- "name": "custom manifest",
1979- "start_url": "https://boo",
1980- "icons": [
1981- {
1982- "src": "//icons.example.com/lowres"
1983- },
1984- {
1985- "src": "//other.com/hi-res"
1986- }
1987- ]
1988- }
1989- </ pre >
1990- < p >
1991- The fetching of icon resources from `icons.example.com/lowres`
1992- would succeed, while fetching from `other.com/hi-res` would fail.
1993- </ p >
1994- </ aside >
1995- </ section >
19961957 < section id ="icon-masks ">
19971958 < h2 >
19981959 Icon masks and safe zone
0 commit comments