--- title: CSS Properties and Values API (Propriétés et valeurs) slug: Web/API/CSS_Properties_and_Values_API translation_of: 'Web/API/CSS_Properties_and_Values_API' ---

{{SeeCompatTable}} 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

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

Exemples

L'exemple suivant utilise {{domxref('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 {{cssxref('@property')}} :

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

Spécifications

{{Specifications("api.CSS.registerProperty")}}

Compatibilité des navigateurs

Voir les interfaces individuelles

Voir aussi