Tableaux de spécifications
Baseline
Widely available
*
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
Chaque page de référence sur MDN doit fournir des informations sur la ou les spécifications dans lesquelles cette API ou technologie a été définie. Cet article montre à quoi ressemblent ces tableaux et explique comment les ajouter.
La définition de la section des spécifications est similaire à celle du tableau de compatibilité, est généralement générée à partir de la même source de données, et apparaît typiquement juste avant celui-ci dans une page.
Tableaux de spécifications standards
La section de spécifications standard doit ressembler à ceci :
## Spécifications
{{Specifications}}
La macro {{Specifications}} génère le tableau des spécifications à partir de la ou des valeurs présentes dans le front-matter de la page.
Par défaut, la ou les valeurs de la clé browser-compat sont utilisées.
Chaque valeur fait référence à une fonctionnalité particulière et à ses informations de compatibilité et de spécification dans le dépôt browser-compat-data (angl.).
Par exemple, la page text-align possède la clé suivante, qui lui permet d'obtenir les informations de spécification associées :
Attention : Cela ne concerne que les pages anglaises.
browser-compat: css.property.text-align
Certaines fonctionnalités ne sont pas maintenues dans le dépôt ci-dessus.
Dans ces cas, les informations de spécification peuvent être ajoutées au front-matter de la page via la clé spec-urls.
Par exemple, l'attribut aria-atomic possède la clé front-matter :
Attention : Cela ne concerne que les pages anglaises.
spec-urls: https://w3c.github.io/aria/#aria-atomic
Le tableau des spécifications pour la clé css.property.text-align ci-dessus est affiché ainsi :
Spécifications
| Specification |
|---|
| CSS Logical Properties and Values Level 1 # text-align |
| CSS Text Module Level 3 # text-align-property |
Fonctionnalités non standard
Lors de la documentation d'une fonctionnalité non standard, en particulier si elle a été retirée d'un processus de standardisation, n'utilisez pas la macro {{Specifications}}.
Essayez plutôt de fournir des informations sur le statut de la fonctionnalité et d'éventuelles alternatives. Exemples :
- Cette méthode n'est plus sur une voie de standardisation. Elle est conservée pour des raisons de compatibilité. Utilisez plutôt cette autre méthode.
- Cette méthode faisait initialement partie de DOM Level 2 Traversal and Range (angl.), mais est absente de la spécification DOM actuelle. Cette fonctionnalité n'est plus destinée à devenir un standard.
- Ce gestionnaire d'événement faisait partie de l'ancienne API WebVR (angl.) qui a été remplacée par la WebXR Device API (angl.). Elle n'est plus destinée à devenir un standard.