@@ -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 | } |
@@ -329,9 +329,7 @@ <h3>
|
329 | 329 | </p> |
330 | 330 | <p class="note" title="Platform usage guidance for authors"> |
331 | 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 |
| 332 | + is not representative of a universal experience. For instance, an OS-specific `platform` designation |
335 | 333 | should be reserved for instances where the screenshot includes |
336 | 334 | functionality only available on that specific platform. |
337 | 335 | </p> |
@@ -346,24 +344,6 @@ <h3>
|
346 | 344 | ({{ImageResource/sizes}}) in determining if the screenshot should be |
347 | 345 | displayed. |
348 | 346 | </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 | 347 | <p> |
368 | 348 | List of `platform` values that are specific to an operating system: |
369 | 349 | </p> |
@@ -467,6 +447,47 @@ <h3>
|
467 | 447 | </p> |
468 | 448 | </section> |
469 | 449 | </section> |
| 450 | +<section> |
| 451 | +<h3> |
| 452 | + `form_factor` member |
| 453 | +</h3> |
| 454 | +<p> |
| 455 | + The <code><dfn class="export">form_factor</dfn></code> member is a <a>string</a> that |
| 456 | + represents the shape of a broad class of distribution platforms for which a given screenshot |
| 457 | + applies. Authors are encouraged to only use this member when the |
| 458 | + screenshot is only applicable in a specific context. |
| 459 | +</p> |
| 460 | +<p class="note" title="Platform usage guidance for authors"> |
| 461 | + Authors should only use `platform` for instances where a screenshot |
| 462 | + is not representative of a universal experience. For instance, if the |
| 463 | + layout/design differs based on the screen orientation, setting "narrow" or |
| 464 | + "wide" is advisable. |
| 465 | +</p> |
| 466 | +<p> |
| 467 | + User agents might show as many (or as few) screenshots as they |
| 468 | + choose, but shouldn't display screenshots that do not pertain to |
| 469 | + their form_factor (e.g., Android phone shouldn't show wide form_factor screenshots). |
| 470 | +</p> |
| 471 | +<p> |
| 472 | + List of `form_factor` values: |
| 473 | +</p> |
| 474 | +<dl> |
| 475 | +<dt> |
| 476 | + narrow |
| 477 | +</dt> |
| 478 | +<dd> |
| 479 | + For screenshots applicable to narrow screens only (e.g., mobile devices). |
| 480 | +</dd> |
| 481 | +<dt> |
| 482 | + wide |
| 483 | +</dt> |
| 484 | +<dd> |
| 485 | + For screenshots applicable to wide screens only (e.g., status |
| 486 | + boards). |
| 487 | +</dd> |
| 488 | +</dl> |
| 489 | +</section> |
| 490 | +</section> |
470 | 491 | <section id="internationalization" class="appendix informative"> |
471 | 492 | <h2> |
472 | 493 | Internationalization |
|