Hex vers OKLCH : Migrer ses Design Tokens vers Tailwind CSS v4
Guide pas à pas pour convertir vos thèmes Hex/HSL Tailwind v3 en variables CSS @theme oklch() avec clarté perçue uniforme et Display P3.
Résumé
| Critère | Hex / HSL hérité (Tailwind v3) | OKLCH @theme (Tailwind v4) |
|---|---|---|
| Syntaxe | Chaînes Hex dans tailwind.config.js | CSS @theme --color-* : oklch(...) |
| Uniformité perçue | Non — le jaune paraît bien plus clair que le bleu | Oui — l'axe L suit la clarté ressentie |
| Large gamut P3 | Limité au sRGB 8 bits | Nativement prêt pour Display P3 & Rec.2020 |
| Teintes dynamiques | Calcul préprocesseur requis | CSS natif oklch(from var(--c) ...) |
Pourquoi Tailwind v4 a remplacé Hex par OKLCH par défaut
Les codes Hex masquent la luminance perçue : un bleu 500 et un jaune 500 ont des contrastes radicalement différents sans vérification manuelle.
OKLCH place la Clarté (L) en premier, Chroma (C) en second et Teinte (H) en troisième pour garder des composants visuellement équilibrés.
- Échelles 50–950 cohérentes : texte sombre lisible sur 50–400, texte blanc sur 600–950.
- Couleurs relatives CSS natives sans plugin Sass ni PostCSS.
Transposer theme.extend.colors vers CSS @theme
Collez votre configuration ou vos variables :root dans le convertisseur Colr pour calculer chaque valeur W3C oklch() exacte via sRGB linéaire D65.
Remplacez les palettes Hex statiques de tailwind.
CSS@import "tailwindcss";
@theme {
--color-brand-50: oklch(97.2% 0.014 261.2);
--color-brand-500: oklch(54.6% 0.215 262.9);
--color-brand-700: oklch(42.4% 0.178 263.5);
--color-brand-950: oklch(23.1% 0.086 264.1);
}Contrôler les contrastes WCAG 2.2 et APCA après migration
Vérifiez toute rampe 50–950 avant mise en ligne,
notamment les boutons 500–600 sous texte blanc.
- Valider un ratio 4.5:1 sur les niveaux 500 et 600.
- Inspecter les replis sRGB des teintes large gamut.
Outils cités dans ce guide
Formats associés
Questions fréquentes
Les couleurs oklch() cassent-elles les anciens navigateurs ?
Chrome, Safari, Firefox et Edge depuis 2023 supportent oklch() nativement ; des replis Hex optionnels restent possibles.
Hex et OKLCH sont-ils identiques sur écran sRGB classique ?
Oui — tant que vous ne poussez pas le Chroma dans Display P3, le rendu est strictement identique.
Spécifications et références officielles
Autres guides couleur
- OKLCH vs HSL vs sRGB : Comprendre le large gamut Display P3Comparez HSL, Hex sRGB, Display P3 et OKLCH : clarté perçue, dégradés propres, volume chromatique et amélioration progressive CSS.
- W3C Design Tokens (DTCG 2025.10) : Des variables Figma au CSSStructurez des tokens neutres en W3C DTCG 2025.10 JSON ($type, $value colorSpace et components), alias et export vers CSS et Tailwind v4.
- Contraste WCAG 2.2 vs APCA (Lc) : Guide complet d'accessibilitéComparez les ratios WCAG 2.2 (4.5:1) au contraste perçu APCA (Lc 60/75/90), la polarité mode sombre et la simulation du daltonisme CVD.
- Une couleur en RGB, HSL, HSV, HWB et OKLabVérifiez un sélecteur, une déclaration CSS ou un shader avec #336699. Comparez huit écritures de la même couleur et contrôlez la précision du retour en RGB.