var()
Insère la valeur d’une variable CSS, c’est-à-dire d’une propriété personnalisée notée --nom. Permet aussi de fournir une valeur de repli.
Exemple
#:root {
--brand: #7c3aed;
--radius: 12px;
}
.alert {
--tone: var(--brand);
padding: 12px 14px;
border-left: 4px solid var(--tone);
border-radius: var(--radius);
background: color-mix(in srgb, var(--tone) 15%, transparent);
}
.alert.error {
--tone: #f43f5e;
}<div style="display: grid; gap: 8px;">
<div class="alert">Une nouvelle leçon est disponible.</div>
<div class="alert error">Impossible d’enregistrer la progression.</div>
</div>La variante .error ne change qu’une seule variable. La couleur de la barre et de l’arrière-plan se recalculent toutes seules, car les deux déclarations utilisent --tone.
Définition et utilisation
#Les variables CSS (officiellement : propriétés personnalisées) se déclarent comme des propriétés ordinaires, sauf que le nom commence par deux tirets : --brand-color: #7c3aed;. La fonction var(--brand-color) insère cette valeur dans n’importe quelle déclaration. Modifier une variable modifie tous les endroits qui l’utilisent, même en direct, par exemple lors d’un changement de thème.
Les variables suivent la cascade et l’héritage comme toute propriété. Déclarées sur :root, elles agissent sur toute la page ; déclarées sur un élément, seulement dans celui-ci et ses descendants. Un composant peut donc redéfinir une variable localement (.alert { --color: #f43f5e; }) sans toucher au reste de la page. La casse compte : --Color et --color sont deux variables différentes.
Le second argument est une valeur de repli : var(--gap, 16px) utilisera 16px si la variable n’existe pas. Tout ce qui suit la première virgule est traité comme une seule valeur, donc var(--font, Georgia, serif) est valide. Le repli peut aussi être un autre var(), par exemple var(--accent, var(--brand-color)).
Le navigateur ne vérifie pas le contenu d’une variable au moment de la déclaration. Si vous l’insérez là où elle ne convient pas, par exemple --gap: red dans padding, la déclaration ne revient pas à une règle précédente mais prend la valeur initiale ou héritée. Une variable ne peut être utilisée que comme valeur, jamais comme nom de propriété ni comme fragment de sélecteur.
Syntaxe
#--nom: valeur;
propriété: var(--nom, <valeur de repli>?);Variantes d’utilisation
#couleur du parent
Une variable déclarée sur le conteneur atteint le bouton et l’étiquette, car elle est héritée vers le bas de l’arbre.valeur de repli
Personne n’a déclaré la variable--cta, donc le bouton reçoit la valeur de repli indiquée après la virgule.redéfinition dans un composant
L’étiquette redéfinit la variable localement. Le bouton utilise toujours la valeur du parent, car le changement ne concerne que l’étiquette et ses descendants.repli vers une autre variable
--accentest absente, donc le navigateur se rabat sur la seconde variable,--brand. C’est ainsi qu’on construit une chaîne : d’abord une couleur précise, puis, à défaut, une couleur générale.un nombre converti en longueur
La variable ne contient qu’un nombre, etcalc()le convertit en unité. Le bouton et l’étiquette reçoivent un texte de 1,4rem.valeur invalide
La variable existe, mais20pxn’est pas une couleur. La valeur de repli n’intervient pas, car la variable n’est pas vide : le bouton perd son arrière-plan, et l’étiquette sa bordure et sa couleur.
Variantes d’utilisation en pratique
#var(--brand)
.demo { --brand: #7c3aed; }var(--cta, #0ea5e9)
--cta, donc le bouton reçoit la valeur de repli indiquée après la virgule..btn { background: var(--cta, #0ea5e9); }.tag { --brand: … }
.demo { --brand: #7c3aed; }
.tag { --brand: #f43f5e; }var(--accent, var(--brand))
--accent est absente, donc le navigateur se rabat sur la seconde variable, --brand. C’est ainsi qu’on construit une chaîne : d’abord une couleur précise, puis, à défaut, une couleur générale..demo { --brand: #10b981; }
.btn {
background: var(--accent, var(--brand));
}calc(var(--scale) * 1rem)
calc() le convertit en unité. Le bouton et l’étiquette reçoivent un texte de 1,4rem..demo { --scale: 1.4; }
.btn,
.tag {
font-size: calc(var(--scale) * 1rem);
}--brand: 20px
20px n’est pas une couleur. La valeur de repli n’intervient pas, car la variable n’est pas vide : le bouton perd son arrière-plan, et l’étiquette sa bordure et sa couleur..demo { --brand: 20px; }Plus d’exemples
#.spotlight {
background:
radial-gradient(circle at var(--x, 50%) var(--y, 50%), rgb(124 58 237 / 0.45), transparent 60%),
#18181b;
}<div class="spotlight" style="display: grid; place-items: center; height: 140px; border: 1px solid #27272a; border-radius: 14px;">Déplacez le curseur sur la carte</div>
<script>
const card = document.querySelector('.spotlight')
card.addEventListener('pointermove', (event) => {
card.style.setProperty('--x', event.offsetX + 'px')
card.style.setProperty('--y', event.offsetY + 'px')
})
</script>Le script ne définit que deux variables, --x et --y, et CSS fait le reste. Tant que vous ne bougez pas le curseur, c’est la valeur de repli qui s’applique : le centre de la carte.
Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- La valeur de repli ne s’applique que si la variable n’existe pas. Si elle existe mais a une valeur invalide,
var()ne se rabat pas sur le repli. - Vous pouvez lire et modifier les variables depuis JavaScript :
getComputedStyle(el).getPropertyValue("--brand")etel.style.setProperty("--brand", "#10b981"). - Une variable ne colle pas d’unité à un nombre :
var(--n)pxne fonctionne pas. Utilisezcalc(var(--n) * 1px).
Entrées associées
#- :rootCorrespond à l’élément racine du document, en HTML à la balise html. L’emplacement habituel pour les variables CSS de toute la page.
- @propertyEnregistre une variable CSS avec un type, une valeur initiale et une règle d’héritage. Une telle variable peut être animée en douceur, par ex. l’angle d’un dégradé.
- calc()Calcule une valeur à partir d’une opération mathématique et permet de combiner différentes unités, par exemple des pourcentages avec des pixels.
- color-mix()Mélange deux couleurs dans des proportions données et dans l’espace colorimétrique choisi. Crée des variantes plus claires, plus sombres et semi-transparentes.
- clamp()Maintient une valeur entre un minimum et un maximum, et la laisse croître en douceur entre les deux. La base de la typographie fluide.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.