Hex a OKLCH: Guía de migración de Design Tokens a Tailwind CSS v4
Guía paso a paso para actualizar temas Hex y HSL de Tailwind v3 a variables CSS @theme oklch() con brillo perceptual estable y Display P3.
Resumen
| Criterio | Hex / HSL legado (Tailwind v3) | OKLCH @theme (Tailwind v4) |
|---|---|---|
| Sintaxis | Cadenas Hex en tailwind.config.js | CSS @theme --color-* : oklch(...) |
| Uniformidad perceptual | No — el amarillo brilla más que el azul | Sí — el eje L sigue el brillo percibido |
| Gama Display P3 | Recortado a sRGB de 8 bits | Listo para Display P3 y Rec.2020 |
| Tintes dinámicos | Requiere funciones de preprocesador | CSS nativo oklch(from var(--c) ...) |
Por qué Tailwind v4 cambió las paletas base de Hex a OKLCH
Las cadenas Hex ocultan la luminosidad real: dos tonos nivel 500 en azul y amarillo tienen contrastes completamente distintos sin auditoría manual.
OKLCH coloca la Luminosidad perceptual (L) en primer lugar, Croma (C) en segundo y Tono (H) en tercero, manteniendo el peso visual uniforme.
- Escaleras 50–950 coherentes: texto oscuro pasa con seguridad sobre 50–400 y blanco sobre 600–950.
- Colores relativos nativos de CSS sin plugins Sass ni PostCSS.
Mapear theme.extend.colors de tailwind.config.js a @theme
Pega tus colores Hex de Tailwind v3 o variables :root en el conversor de Colr para transformar cada paso por sRGB lineal D65 hacia oklch() exacto.
Reemplaza las paletas estáticas Hex 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);
}Verificar contraste WCAG 2.2 y APCA tras migrar
Audita siempre tus rampas 50–950 antes de pasar a producción,
especialmente en botones intermedios 500–600 con texto blanco.
- Comprueba pasos 500 y 600 para asegurar relación 4.5:1 en botones.
- Revisa la vista previa de respaldo sRGB para acentos wide-gamut.
Herramientas usadas en esta guía
Formatos relacionados
Preguntas frecuentes
¿Rompen los colores oklch() navegadores más antiguos?
Chrome, Safari, Firefox y Edge modernos desde 2023 soportan oklch() nativamente; puedes mantener respaldos Hex opcionales si das soporte heredado.
¿Se ven idénticos Hex y OKLCH en monitores sRGB estándar?
Sí, un Hex convertido a oklch() representa exactamente el mismo color hasta que aumentes deliberadamente C hacia Display P3.
Especificaciones y referencias oficiales
Más guías de color
- OKLCH vs HSL vs sRGB: Entendiendo la gama amplia Display P3Compara HSL, Hex sRGB, Display P3 y OKLCH en luminosidad perceptual, degradados limpios, volumen cromático y mejora progresiva en CSS.
- W3C Design Tokens (DTCG 2025.10): Variables de Figma a CSSEstructura tokens neutrales con W3C DTCG 2025.10 JSON ($type, $value colorSpace y components), alias y exportación directa a CSS y Tailwind v4.
- Contraste WCAG 2.2 vs APCA (Lc): Guía completa de accesibilidadCompara ratios de luminancia WCAG 2.2 (4.5:1) con el contraste perceptual APCA (Lc 60/75/90), polaridad en modo oscuro y daltonismo CVD.
- Un color en RGB, HSL, HSV, HWB y OKLabComprueba un selector, una declaración CSS o un shader con #336699. Compara ocho notaciones de la misma muestra y revisa la precisión al volver a RGB.