CSS Properties and Values API (Propriétés et valeurs)

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

L' API Propriétés et valeurs CSS — qui fait partie de l'ensemble d'API CSS Houdini — sert à définir explicitement des propriétés CSS personnalisées , ce qui permet la vérification des types de propriétés, de leur donner des valeurs par défaut et de déterminer si une propriété peut hériter ses valeurs ou non.

Interfaces

CSS.registerProperty: Définit la manière dont un navigateur devrait analyser une propriété CSS personnalisée. L'accès à cette interface se fait en JavaScript via CSS.registerProperty.
@property: Définit la manière dont un navigateur devrait analyser une propriété CSS personnalisée. L'accès à cette interface se fait à l'aide d'une règle at-rule @property en CSS.

Exemples

L'exemple suivant utilise CSS.registerProperty en JavaScript pour typer une propriété CSS personnalisée, --ma-couleur en tant que couleur et que valeur par défaut, sans lui permettre d'hériter de sa valeur :

window.CSS.registerProperty({
  name: "--ma-couleur",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

Le même enregistrement peut se faire en CSS en utilisant la règle at-rule @property :

css

@property --ma-couleur {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

Spécifications

Specification
CSS Properties and Values API Level 1 # the-css-property-rule-interface
CSS Properties and Values API Level 1 # the-registerproperty-function

Compatibilité des navigateurs

Voir les interfaces individuelles

Voir aussi

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨7 sept. 2025⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content