var()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.
La fonction var()
peut être utilisée à la place d'une valeur pour n'importe quelle propriété d'un élément. Elle permet d'insérer la valeur d'une propriété personnalisée (custom property).
var(--header-color, blue);
La fonction var()
ne peut pas être utilisée pour les noms de propriété, les sélecteurs et pour tout ce qui n'est pas une valeur de propriété.
Syntaxe
Le premier argument de la fonction est le nom de la propriété qu'on veut substituer. Le deuxième argument, optionnel, est une valeur de recours (fallback) qui est utilisée au cas où la valeur de subsitution référencée par la propriété est invalide.
<var()> =
var( <custom-property-name> , <declaration-value>? )
Note :
La syntaxe de la valeur de recours permet d'utiliser des virgules. Aussi, si on a var(--toto, red, blue)
, la valeur de recours sera bien red, blue
(autrement dit, tout ce qui est situé après la première virgule sert de valeur de recours).
Valeurs
<custom-property-name>
-
Le nom d'une propriété personnalisée, représenté par un identifiant valide qui commence par deux tirets. Les propriétés personnalisées sont uniquement utilisées par les auteurs et les utilisateurs. CSS ne définit pas leur valeur ou leur sémantique.
<declaration-value>
-
Une valeur de subsitution qui peut être utilisée afin que la règle soit valide si la valeur du premier argument ne peut être utilisée ici.
Exemples
:root {
--main-bg-color: pink;
}
body {
background-color: var(--main-bg-color);
}
/* On ajoute un paramètre de secours */
.component .header {
color: var(--header-color, blue); // à ce moment header-color n'est pas définie, c'est donc le bleu qui est utilisé
}
.component .text {
color: var(--text-color, black);
}
.component {
--text-color: #080;
}
Spécifications
Specification |
---|
CSS Custom Properties for Cascading Variables Module Level 1 # using-variables |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
env(…)
– variables d'environnement en lecture seule, contrôlées par l'agent utilisateur.- Utiliser les variables CSS