@@ -311,7 +311,7 @@ <h3>
|
311 | 311 | "screenshots": [{ |
312 | 312 | "src": "images/screenshot.png", |
313 | 313 | "sizes": "800x600", |
314 | | - "platform": "wide", |
| 314 | + "form_factor": "wide", |
315 | 315 | "label": "With Software, you can select a part of your screen and take a screenshot in seconds." |
316 | 316 | }] |
317 | 317 | } |
@@ -328,12 +328,11 @@ <h3>
|
328 | 328 | screenshot is only applicable in a specific context. |
329 | 329 | </p> |
330 | 330 | <p class="note" title="Platform usage guidance for authors"> |
331 | | - Authors should only use `platform` for instances where a screenshot |
332 | | - is not representative of a universal experience. For instance, if the |
333 | | - layout/design differs based on orientation, setting "narrow" or |
334 | | - "wide" is advisable. Similarly, an OS-specific `platform` designation |
335 | | - should be reserved for instances where the screenshot includes |
336 | | - functionality only available on that specific platform. |
| 331 | + Authors should only use `platform` for instances where a screenshot is |
| 332 | + not representative of a universal experience. For instance, an |
| 333 | + OS-specific `platform` designation should be reserved for instances |
| 334 | + where the screenshot includes functionality only available on that |
| 335 | + specific platform. |
337 | 336 | </p> |
338 | 337 | <p> |
339 | 338 | User agents might show as many (or as few) screenshots as they |
@@ -346,24 +345,6 @@ <h3>
|
346 | 345 | ({{ImageResource/sizes}}) in determining if the screenshot should be |
347 | 346 | displayed. |
348 | 347 | </p> |
349 | | -<p> |
350 | | - List of general-purporse `platform` values: |
351 | | -</p> |
352 | | -<dl> |
353 | | -<dt> |
354 | | - narrow |
355 | | -</dt> |
356 | | -<dd> |
357 | | - For narrow screenshots (e.g., wearables, mobile devices). |
358 | | -</dd> |
359 | | -<dt> |
360 | | - wide |
361 | | -</dt> |
362 | | -<dd> |
363 | | - For screenshots applicable to wide screens only (e.g., status |
364 | | - boards). |
365 | | -</dd> |
366 | | -</dl> |
367 | 348 | <p> |
368 | 349 | List of `platform` values that are specific to an operating system: |
369 | 350 | </p> |
@@ -467,6 +448,49 @@ <h3>
|
467 | 448 | </p> |
468 | 449 | </section> |
469 | 450 | </section> |
| 451 | +<section> |
| 452 | +<h3> |
| 453 | + `form_factor` member |
| 454 | +</h3> |
| 455 | +<p> |
| 456 | + The <code><dfn data-for="manifest" class="export">form_factor</dfn></code> member is a |
| 457 | +<a>string</a> that represents the screen shape of a broad class of |
| 458 | + devices for which a given screenshot applies. Authors are encouraged to |
| 459 | + only use this member when the screenshot is only applicable in a |
| 460 | + specific context. |
| 461 | +</p> |
| 462 | +<p class="note" title="form_factor usage guidance for authors"> |
| 463 | + Authors should only use `form_factor` for instances where a screenshot |
| 464 | + is not representative of a universal experience. For instance, if the |
| 465 | + layout/design differs based on the screen orientation, setting "narrow" or |
| 466 | + "wide" is advisable. |
| 467 | +</p> |
| 468 | +<p> |
| 469 | + User agents might show as many (or as few) screenshots as they choose, |
| 470 | + but shouldn't display screenshots that do not pertain to their |
| 471 | + form factor (e.g., mobile phones shouldn't show "wide" `form_factor` |
| 472 | + screenshots). |
| 473 | +</p> |
| 474 | +<p> |
| 475 | + List of `form_factor` values: |
| 476 | +</p> |
| 477 | +<dl> |
| 478 | +<dt> |
| 479 | + narrow |
| 480 | +</dt> |
| 481 | +<dd> |
| 482 | + For screenshots applicable to narrow screens only (e.g., mobile devices). |
| 483 | +</dd> |
| 484 | +<dt> |
| 485 | + wide |
| 486 | +</dt> |
| 487 | +<dd> |
| 488 | + For screenshots applicable to wide screens only (e.g., status |
| 489 | + boards). |
| 490 | +</dd> |
| 491 | +</dl> |
| 492 | +</section> |
| 493 | +</section> |
470 | 494 | <section id="internationalization" class="appendix informative"> |
471 | 495 | <h2> |
472 | 496 | Internationalization |
|