Modèle de page de propriété CSS

Note : Supprimez cette note explicative avant de publier.

Page de garde :

Les métadonnées en haut de la page sont utilisées pour définir les « métadonnées de la page ». Les valeurs doivent être mises à jour de manière appropriée pour l'interface particulière.

---
title: nom-de-la-propriété
slug: Web/CSS/Reference/Properties/name-of-the-property
page-type: css-property OR css-shorthand-property
status:
  - deprecated
  - experimental
  - non-standard
browser-compat: css.properties.name-of-the-property
sidebar: cssref
---

title

La valeur title est affichée en haut de la page. Le format du titre est nom-de-la-propriété. Par exemple, la propriété background-color a pour titre background-color.

slug

La valeur slug est la fin du chemin URL après https://developer.mozilla.org/fr/docs/. C'est formaté comme Web/CSS/Reference/Properties/nom-de-la-propriété. Par exemple, le slug pour la propriété background-color est Web/CSS/Reference/Properties/background-color. Pour un composant multi-mots tel que Getting_started dans un slug, le slug doit utiliser un underscore comme dans /fr/docs/Learn_web_development/Core/Structuring_content.

page-type (pages anglaises uniquement)

La valeur page-type pour les propriétés CSS est css-property. Pour une propriété CSS abrégée, la valeur est css-shorthand-property. Par exemple, la valeur page-type pour la propriété animation est css-shorthand-property, car c'est une propriété abrégée, tandis que la valeur page-type pour la propriété animation-delay est css-property.

status (pages anglaises uniquement)

Indique l'état de cette fonctionnalité. Un tableau pouvant contenir une ou plusieurs des valeurs suivantes : experimental, deprecated, non-standard. Cette clé ne doit pas être définie manuellement : elle est définie automatiquement en fonction des valeurs dans les données de compatibilité des navigateurs pour la fonctionnalité. Voir « Comment les statuts des fonctionnalités sont ajoutés ou mis à jour ».

browser-compat (pages anglaises uniquement)

Remplacez la valeur de l'espace réservé css.properties.NameOfTheProperty par la chaîne de requête pour la propriété dans le dépôt de données de compatibilité des navigateurs ^(angl.). Consultez la section Autres macros dans la page de ce bloc de notes pour voir comment cette clé-valeur est utilisée pour générer le contenu des sections Spécifications et Compatibilité des navigateurs.

sidebar (pages anglaises uniquement)

Il s'agit de cssref pour toutes les pages de guide et de référence CSS. Voir Structures de page : Barres latérales pour plus de détails.

Macros en haut de page

Un certain nombre d'appels de macros apparaissent en haut de la section de contenu (immédiatement sous les métadonnées de la page). Ces macros sont ajoutées automatiquement par la chaîne d'outils (il n'est pas nécessaire de les ajouter/supprimer) :

• {{SeeCompatTable}} — Cette macro génère une bannière Expérimentale, qui indique que la technologie est expérimentale. Si la technologie est expérimentale et est cachée derrière une préférence dans Firefox, vous devez également remplir une entrée pour elle dans la page Fonctionnalités expérimentales dans Firefox.
• {{Deprecated_Header}} — Cette macro génère une bannière Obsolète, qui indique que l'utilisation de la technologie est déconseillée.
• {{Non-standard_Header}} — Cette macro génère une bannière Non standard qui indique que la fonctionnalité ne fait partie d'aucune spécification.

Ne fournissez pas manuellement les macros d'en-tête de statut :

Reportez-vous à la section « Comment les statuts des fonctionnalités sont ajoutés ou mis à jour » pour ajouter ces statuts à la page.

Des exemples des bannières Expérimentale, Obsolète et Non standard sont présentés juste après ce bloc de notes.

Autres macros dans la page

• Section de syntaxe formelle : Le contenu de la section Syntaxe formelle est généré à l'aide de la macro {{CSSSyntax}}. Cette macro récupère les données à partir des spécifications en utilisant le package npm @webref/css ^(angl.).

• Section de définition formelle : Le contenu de la section Définition formelle est généré à l'aide de la macro {{CSSInfo}}. Pour que cette section contienne des données, vous devez vous assurer qu'une entrée appropriée a été remplie pour la propriété correspondante dans le fichier de données properties.json ^(angl.) du dépôt mdn/data. Voir la page Properties ^(angl.) pour plus d'informations.

• Sections Spécifications et Compatibilité des navigateurs : L'outil de construction utilise automatiquement la paire clé-valeur browser-compat à partir des métadonnées de la page pour insérer des données dans les sections Spécifications et Compatibilité des navigateurs (remplaçant les macros {{Specifications}} et {{Compat}} dans ces sections, respectivement).

  Notez que vous devez d'abord créer/met à jour une entrée pour la propriété et sa spécification dans notre dépôt de données de compatibilité des navigateurs ^(angl.). Consultez notre guide des tableaux de compatibilité pour des informations sur l'ajout ou la modification des entrées.

Supprimez cette note explicative avant de publier.