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

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.

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 :

js
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