@@ -300,27 +300,33 @@ <h3>
300300 Declaring multiple icons
301301 </ h3 >
302302 < p >
303- In the following example, the developer has made the following
304- choices about the icons associated with the web application:
303+ This section shows how to declare multiple icons using the
304+ [=manifest/icons=] member to declare a set of icons for your web
305+ application. In the following example, the developer has made the
306+ following choices about the icons associated with the web
307+ application:
305308 </ p >
306309 < ul >
307310 < li > The developer has included two icons at the same size, but in
308311 two different formats. One is explicitly marked as WebP through the
309- `type` member. If the user agent doesn't support WebP, it falls
312+ `type` member. If the user agent doesn't support WebP, it can fall
310313 back to the second icon of the same size. The < a > MIME type</ a > of
311314 this icon can then be either determined via a HTTP header, or can
312315 be < a data-lt ="computed mime type "> sniffed</ a > by the user agent
313316 once the first few bytes of the icon are received.
314317 </ li >
315- < li > The developer wants to use an SVG for greater than or equal to
316- 257x257px. They've found that the SVG file looks too blurry at
317- small sizes, even on high-density screens. To deal with this
318- problem, the developer includes an SVG icon that is only used when
319- the dimensions are at least 257px. Otherwise, the user agent uses
320- the ICO file (hd_hi.ico), which includes a gamut of raster icons
321- individually tailored for small display sizes.
318+ < li > The developer specifies various sizes for the pixel-based icon
319+ formats. These serve as hints for the user agent to determine a
320+ suitable icon. The user has also included an ICO file (hd_hi.ico),
321+ which includes a gamut of raster icons individually tailored for
322+ various sizes, and an SVG icon that can be resized dynamically to
323+ fit any icon size needed.
322324 </ li >
323325 </ ul >
326+ < p >
327+ The list of icons is provided to the user agent, which will choose
328+ the most suitable icons for different contexts and placements.
329+ </ p >
324330 < pre class ="example json " title ="Multiple icons ">
325331 {
326332 "icons": [
335341 "src": "icon/hd_hi.ico",
336342 "sizes": "72x72 96x96 128x128 256x256"
337343 },{
338- "src": "icon/hd_hi.svg",
339- "sizes": "257x257"
344+ "src": "icon/hd_hi.svg"
340345 }]
341346 }
342347 </ pre >
0 commit comments