Statut des fonctionnalités
Le statut d'une fonctionnalité indique globalement l'état d'implémentation entre les navigateurs et de standardisation d'une fonctionnalité de la plateforme web, comme une méthode d'API Web ou une propriété CSS.
Il s'agit de l'un des statuts suivants :
Attention :
Ne mettez pas à jour manuellement les statuts des fonctionnalités dans les dépôts mdn/content et mdn/translated-content.
La source de la documentation est mise à jour automatiquement à partir des informations du dépôt GitHub mdn/browser-compat-data.
Si aucun des statuts ci-dessus ne s'applique, la fonctionnalité est considérée comme stable et standard. Pour plus d'informations sur ces termes, voir la page « Expérimental, déprécié et obsolète ».
Pour savoir comment le statut d'une fonctionnalité est déterminé, voir la section choisir les propriétés de statut (angl.) dans le dépôt @mdn/browser-compat-data (BCD).
Comment les statuts sont-ils ajoutés ou mis à jour ?
Les statuts de toutes les fonctionnalités documentées sur MDN sont suivis dans le dépôt @mdn/browser-compat-data (angl.) (BCD). Une automatisation met à jour automatiquement les statuts dans le dépôt mdn/content (et s'applique sur mdn/translated-content par héritage) à chaque nouvelle version de BCD.
L'automatisation utilise la clé browser-compat dans le front-matter. Cette clé contient la requête BCD permettant de localiser la fonctionnalité dans les données de compatibilité. Si la clé browser-compat a plusieurs valeurs, seule la première est utilisée pour afficher les macros de statut.
Note :
Pour mettre à jour le statut d'une fonctionnalité dans le contenu MDN, vous devez soumettre une requête de tirage (angl.) dans le dépôt BCD. Après validation et fusion de vos modifications dans BCD, elles sont publiées lors d'une version hebdomadaire, puis une pull request automatisée met à jour les statuts dans le dépôt mdn/content à chaque publication.
Comment les statuts sont-ils spécifiés dans le contenu ?
Les sections suivantes documentent les mécanismes utilisés pour insérer et afficher les informations de statut dans les documents MDN. Comme indiqué, ces éléments sont en lecture seule, car leur ajout est automatisé.
Icônes de statut dans les barres latérales
La propriété status dans le front-matter de la page permet de générer les icônes de statut des fonctionnalités affichées dans les barres latérales.
---
title: Nom de la fonctionnalité
status:
- deprecated
- experimental
- non-standard
browser-compat: api.feature
---
Bannières de statut en haut de page
Les macros suivantes servent à afficher les bannières de statut en haut des pages :
{{Deprecated_Header}}-
Pour le statut
deprecated. Affiche une bannière Statut déprécié :Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.
{{SeeCompatTable}}-
Pour le statut
experimental. Affiche une bannière Statut expérimental :Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification. {{Non-standard_Header}}-
Pour le statut
non-standard. Affiche une bannière Statut non standard :Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
Icônes de statut dans les listes de définitions
Les macros suivantes servent à afficher les icônes de statut en ligne à côté des éléments de liste de définitions :
{{Experimental_Inline}}(angl.) icône : Expérimental{{Non-standard_Inline}}(angl.) icône : Non standard{{Deprecated_Inline}}(angl.) icône : Obsolète
Si une page de fonctionnalité web possède une bannière de statut, alors les macros en ligne du même statut sont utilisées explicitement pour chaque membre ou valeur de la fonctionnalité dans la liste de définitions.
Par exemple, si une page est marquée expérimentale avec {{SeeCompatTable}}, chaque membre ou valeur de la fonctionnalité est explicitement marqué expérimental avec la macro {{Experimental_Inline}} dans la liste de définitions.