Skip to content

Commit 345fbe7

Browse files
Editorial: rephrase multiple icon example
1 parent d8bb336 commit 345fbe7

File tree

1 file changed

+17
-12
lines changed

1 file changed

+17
-12
lines changed

index.html

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -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": [
@@ -335,8 +341,7 @@ <h3>
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

Comments
 (0)