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

Baseline 2024

Newly available

Depuis July 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

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 9 nov. 2025 par les contributeurs du MDN.

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