Les tokens de couleur en CSS et Tailwind
· 3 min de lecture
Nommer et organiser les variables de couleur par rôle, relier les modes clair et sombre en CSS et réutiliser les mêmes tokens dans un thème Tailwind v4.
Des valeurs hexadécimales codées en dur et dispersées dans une feuille de style sont la principale raison pour laquelle changer de couleurs devient pénible. Une refonte de marque, l'ajout d'un mode sombre ou la correction d'un problème de contraste se transforment en rechercher-remplacer sur des centaines de lignes. Les tokens de couleur — des variables nommées qui décrivent à quoi sert une couleur — règlent ce problème. Ce guide montre comment les structurer en CSS pur et réutiliser les mêmes tokens dans Tailwind.
Deux couches : primitives et rôles
Une organisation solide sépare ce que sont les couleurs de la façon dont on les utilise.
Les tokens primitifs forment la palette brute, nommée par teinte et par palier. Ils n'apparaissent jamais directement dans les styles des composants.
:root {
--blue-100: #E3E8FF;
--blue-500: #3D5AFE;
--blue-700: #2638C4;
--sand-50: #F7F5F0;
--ink-900: #1D2433;
}Les tokens sémantiques (de rôle) décrivent une fonction dans l'interface et pointent vers une primitive ou portent leur propre valeur. Les composants n'utilisent que ceux-là.
:root {
--color-bg: var(--sand-50);
--color-surface: #EFECE4;
--color-border: #DAD6CC;
--color-text: var(--ink-900);
--color-muted: #5C6475;
--color-primary: var(--blue-500);
--color-on-primary: #FFFFFF;
--color-accent: #C2410C;
}.button {
background: var(--color-primary);
color: var(--color-on-primary);
}
.card {
background: var(--color-surface);
border: 1px solid var(--color-border);
color: var(--color-text);
}Désormais, le bouton ne sait pas qu'il est bleu. Si la marque passe au vert, vous changez une ligne. Si une vérification de contraste échoue, vous ajustez un token et tous les composants suivent.
Nommez les tokens par rôle, pas par apparence
Des noms comme --light-gray ou --brand-blue décrivent l'aspect d'une couleur aujourd'hui. Ils deviennent faux dès que la valeur change — et en mode sombre, --light-gray contiendrait une couleur foncée. Les noms de rôle restent justes :
--color-bg,--color-surface,--color-borderpour la structure.--color-textet--color-mutedpour le contenu.--color-primary,--color-accentpour la mise en avant.--color-on-primary,--color-on-accentpour le texte posé sur des couleurs pleines.- Des rôles d'état facultatifs :
--color-success,--color-warning,--color-danger.
Gardez une liste courte. Une douzaine de tokens de rôle couvrent la plupart des produits ; ajouter un token par composant ramène le problème de départ.
Le mode sombre devient un jeu de nouvelles valeurs
Avec des tokens de rôle, le mode sombre n'est pas une seconde feuille de style. Ce sont les mêmes noms avec d'autres valeurs. Le modèle ci-dessous suit le réglage du système tout en permettant à un interrupteur d'imposer l'un ou l'autre thème avec un attributdata-theme :
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--color-bg: #14161F;
--color-surface: #1C1F2B;
--color-border: #2C3040;
--color-text: #E6E8EF;
--color-muted: #9AA1B2;
--color-primary: #8C9EFF;
--color-on-primary: #14161F;
--color-accent: #FB923C;
}
}
:root[data-theme="dark"] {
/* les mêmes valeurs, pour qui choisit le sombre à la main */
}Notez que la principale du mode sombre est un bleu plus clair et que son libellé est foncé. Les valeurs sombres doivent être choisies, pas calculées par inversion — le guide du mode sombre explique pourquoi.
Les navigateurs récents prennent aussi en charge la fonction light-dark(), qui garde les deux valeurs sur une seule ligne. Elle suit la propriété color-scheme, qu'il faut donc déclarer pour qu'elle fonctionne :
:root {
color-scheme: light dark;
--color-bg: light-dark(#F7F5F0, #14161F);
--color-text: light-dark(#1D2433, #E6E8EF);
}Dérivez les couleurs discrètes
Les surfaces et les bordures peuvent être mélangées à partir du fond et du texte au lieu d'être choisies à la main.color-mix() le fait en CSS, et un mélange en OKLCH donne des paliers réguliers et naturels :
:root {
--color-surface: color-mix(in oklch, var(--color-bg) 94%, var(--color-text));
--color-border: color-mix(in oklch, var(--color-bg) 82%, var(--color-text));
}Comme ils font référence à d'autres tokens, ils se mettent à jour automatiquement en mode sombre. Vérifiez que la bordure atteint 3:1 si elle délimite un champ ou un autre contrôle.
Utiliser les tokens dans Tailwind CSS v4
Tailwind v4 se configure en CSS. Toute variable --color-* déclarée dans @theme devient un jeu complet d'utilitaires (bg-*, text-*, border-*, etc.). Les utilitaires générés lisent la variable à l'exécution — bg-primary devient background-color: var(--color-primary) —, il suffit donc de redéfinir la variable pour le mode sombre :
@import "tailwindcss";
/* les valeurs claires deviennent des utilitaires : bg-bg, text-text, bg-primary ... */
@theme {
--color-bg: #F7F5F0;
--color-surface: #EFECE4;
--color-text: #1D2433;
--color-muted: #5C6475;
--color-primary: #3D5AFE;
--color-on-primary: #FFFFFF;
--color-accent: #C2410C;
}
/* les valeurs sombres remplacent les mêmes variables */
@media (prefers-color-scheme: dark) {
:root {
--color-bg: #14161F;
--color-text: #E6E8EF;
--color-primary: #8C9EFF;
--color-on-primary: #14161F;
/* ... */
}
}<button class="bg-primary text-on-primary">Save</button>
<p class="text-muted">Last edited 2 hours ago</p>Inutile d'ajouter des variantes dark: sur chaque élément : les tokens changent déjà, donc bg-primary est correct dans les deux thèmes.
Tailwind v3
En v3, associez les mêmes variables dans le fichier de configuration :
// tailwind.config.js
module.exports = {
theme: {
extend: {
colors: {
bg: 'var(--color-bg)',
surface: 'var(--color-surface)',
text: 'var(--color-text)',
primary: 'var(--color-primary)',
accent: 'var(--color-accent)',
},
},
},
}Écrire les valeurs en OKLCH
L'hexadécimal convient pour stocker des couleurs, mais OKLCH est plus facile à manier quand on les modifie. Ses trois canaux sont la clarté, la chroma (saturation) et la teinte, et la clarté correspond de près à ce que voit l'œil. Pour obtenir une version plus foncée d'une couleur de marque destinée au texte, vous baissez L sans toucher au reste : oklch(55% 0.2 265) devientoklch(42% 0.2 265). Tous les grands navigateurs actuels prennent en charge oklch().
Évitez la saisie
Chaque palette de Colorset s'exporte exactement dans cette structure : tokens de rôle pour les modes clair et sombre en variables CSS, thème Tailwind v4, config Tailwind v3, SCSS, JSON ou design tokens, en HEX, RGB, HSL ou OKLCH. Choisissez une palette qui vous plaît, ouvrez Exporter et collez. Le générateur de nuances crée une échelle primitive 50–950 à partir de n'importe quelle couleur si vous voulez construire vous-même la couche des primitives.