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.

6 min de lecture · Mis à jour le 2026-11-22

Résumé

CritèreHex / HSL hérité (Tailwind v3)OKLCH @theme (Tailwind v4)
SyntaxeChaînes Hex dans tailwind.config.jsCSS @theme --color-* : oklch(...)
Uniformité perçueNon — le jaune paraît bien plus clair que le bleuOui — l'axe L suit la clarté ressentie
Large gamut P3Limité au sRGB 8 bitsNativement prêt pour Display P3 & Rec.2020
Teintes dynamiquesCalcul préprocesseur requisCSS 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.

Convertir un thème Tailwind v3 vers v4 OKLCH

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.

Transposer theme.extend.colors vers CSS @theme
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.

Créer une échelle OKLCH 50–950 accessible

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.

Autres guides couleur