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

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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 (en-US) — 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 (en-US)

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 (en-US).

@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-US) 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

No specification found

No specification data found for api.CSS.registerProperty.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Compatibilité des navigateurs

Voir les interfaces individuelles

Voir aussi