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.
Les noms des propriétés qui sont préfixés par deux tirets : -- (par exemple : --nom-exemple) représentent des propriétés personnalisées (custom properties) qui peuvent contenir une valeur qui pourra être réutilisée dans le document grâce à la fonction var.
Les propriétés personnalisées contribuent à la cascade : une propriété personnalisée peut apparaître plusieurs fois et la valeur utilisée dans la variable correspondra à la variable de la propriété personnalisée déterminée par l'algorithme de la cascade.
| Valeur initiale | voir le texte |
|---|---|
| Applicabilité | tous les éléments |
| Héritée | oui |
| Média | tous |
| Valeur calculée | tel que spécifié avec les variables échangées |
| Type d'animation | discrète |
| Ordre canonique | selon la grammaire |
Syntaxe
--unmotcle: left; --unecouleur: #0000ff; --unevaleurcomplexe: 3px 6px rgb(20, 32, 54);
<declaration-value>- Cette valeur correspond à une séquence de un ou plusieurs fragments tant que la séquence ne contient pas de fragments interdits. Elle représente l'intégralité de ce qu'une déclaration valide peut avoir comme valeur.
Syntaxe formelle
<declaration-value>
Exemples
HTML
<p id="premierParagraphe">Ce paragraphe devrait être sur fond bleu avec un texte jaune.</p> <p id="secondParagraphe">Ce paragraphe devrait être sur fond jaune avec un texte bleu.</p>
CSS
:root {
--premiere-couleur: #488cff;
--seconde-couleur: #ffff8c;
}
#premierParagraphe {
background-color: var(--premiere-couleur);
color: var(--seconde-couleur);
}
#secondParagraphe {
background-color: var(--seconde-couleur);
color: var(--premiere-couleur);
}
Résultat
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| CSS Custom Properties for Cascading Variables Module Level 1 La définition de '--*' dans cette spécification. |
Candidat au statut de recommandation | Définition initiale. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | 49 | 15 | 29 | Non | 36 | Oui |
var() | 49 481 | 15 | 31 | Non | 36 | Oui |
| Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Support simple | 49 | 49 | 15 | 29 | 36 | Oui | 5.0 |
var() | 50 | ? | 15 | 31 | 37 | Oui | ? |
1. From version 48: this feature is behind the Enable experimental Web Platform features preference. To change preferences in Chrome, visit chrome://flags.
2. From Firefox 29 until Firefox 31, this feature was implemented by the var-variablename syntax.
3. From version 29 until version 55 (exclusive): this feature is behind the layout.css.variables.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.