Cómo generar una paleta de colores accesible a partir de un solo color
El método que usa TaishoDS Core: fijar el contraste de cada paso de la escala y calcular el color que lo cumple. Con el error que me llevó ahí y los casos que no cubre.
Pablo Di Filippo
Para sacar una paleta accesible de un solo color, lo que me funcionó fue decidir primero qué contraste tiene que dar cada paso de la escala contra el fondo, y después calcular el color que lo cumple. Mi primer intento fue al revés, repartiendo luminosidades, y falló. Más abajo cuento cómo.
Así está hecho el color de TaishoDS Core, un sistema de diseño en HTML, CSS y JavaScript, sin framework, que acabo de publicar con licencia MIT: el paquete es @taishods/core en npm y el código está en GitHub. Lo probé con 4.096 colores de partida, en modo claro y en oscuro. En los 81.920 pasos que salieron, el texto que va encima de cada paso nunca bajó de 4,63 de contraste; el nivel AA de WCAG pide 4,5.
Empecé TaishoDS porque necesitaba un solo sistema para mis propios productos y para trabajos de clientes. Los sistemas pagos quedaban fuera de mi presupuesto, y en los gratuitos no encontraba juntas la accesibilidad y el rendimiento que buscaba. Entonces puse una regla: la calidad la tiene que imponer el sistema, no la disciplina. En el color, esa regla quiere decir que el contraste se calcula.
El método
La escala tiene diez pasos, del 100 al 1000. Se arma así, en este orden:
- Cada paso recibe un contraste objetivo contra el fondo de la página. Sobre blanco son 1,08, 1,22, 1,5, 2,1, 3,6, 6, 8,5, 12, 16 y 19.
- Se mide el contraste del color de partida contra ese fondo y se lo ubica, sin tocarlo, en el paso que le corresponde.
- Para cada uno de los otros nueve pasos se busca la luminosidad en OKLCH que da su contraste objetivo. El tono se mantiene, salvo en los amarillos, que van más abajo. La saturación nunca supera la del color de partida, baja hacia los extremos de la escala y se recorta a lo que la pantalla puede mostrar.
- El modo oscuro se calcula de nuevo contra el fondo oscuro, con sus propios objetivos. No es el claro invertido.
- A cada paso se le asigna el color de su texto: entre el gris más claro y el más oscuro del sistema, el que dé más contraste.
Con eso el número de paso dice lo mismo con cualquier tono. Un 500 se separa del fondo más o menos igual si es azul o si es amarillo, y un 600 sostiene texto claro encima en los dos casos.
Por qué no alcanza con repartir luminosidades
El primer motor hacía lo más directo. Tomaba el tono y la saturación del color de marca, descartaba su luminosidad y repartía diez luminosidades fijas en OKLCH, de 0,97 en el paso 100 a 0,12 en el 1000. A la vista quedaba parejo, y yo daba por hecho que con eso el contraste salía solo. Era sólo una idea, por lo que venía viendo en las herramientas disponibles.
A fines de octubre lo medí con 648 colores alrededor del círculo cromático. En 45 de ellos, 1 de cada 14, había por lo menos un paso donde el texto de encima quedaba por debajo de AA, y el peor, calculado, daba 4,10. Tampoco aparecía el color de marca en su propia escala: quien pasaba #3b82f6 recibía diez azules y ninguno era #3b82f6.
Lo cuento porque los errores no me avergüenzan: me enseñan. Este tiene una causa simple: el contraste de WCAG se calcula con la luminancia, y dos colores con la misma luminosidad en OKLCH no tienen la misma luminancia. Una escala de luminosidades parejas se ve ordenada y no dice nada sobre si el texto se va a leer.
El mismo número, con cualquier color
Para ver qué cambia sirve una paleta que casi todos tenemos en la cabeza, la de Tailwind. Medí el contraste sobre blanco de cuatro de sus pasos 500 en la versión 4 (tailwindcss 4.3.5), calculado desde sus valores OKLCH. Al lado va el 500 que calcula TaishoDS cuando se parte de ese mismo color:
| Color | 500 en Tailwind 4 | 500 de TaishoDS |
|---|---|---|
Azul (oklch(62.3% 0.214 259.815)) | 3,71 | 3,70 |
Rojo (oklch(63.7% 0.237 25.331)) | 3,82 | 3,82 |
Verde (oklch(72.3% 0.219 149.579)) | 2,25 | 3,60 |
Amarillo (oklch(79.5% 0.184 86.047)) | 1,93 | 3,60 |
Tres de esos cuatro colores caen fuera de sRGB, así que su cifra depende de la pantalla: en una pantalla sRGB, los cuatro dan 3,76, 3,81, 2,22 y 1,91. Tailwind es una paleta fija, que su documentación presenta como diseñada con cuidado por especialistas. Por los números, mi lectura es que cada color está ajustado para verse bien y que el número de paso ordena de claro a oscuro sin buscar un contraste fijo. Para una paleta que viene hecha es una decisión válida. Yo necesitaba otra porque en TaishoDS el color lo elige quien usa el sistema, y a un color cualquiera no lo ajusta nadie a mano.
El azul y el rojo ya daban un contraste de paso 500 y quedan ahí. El verde y el amarillo son más claros: quedan en el 400, y su 500 es un color calculado, más oscuro. Cuando el paso 500 aloja el color de partida conserva el contraste de ese color, que puede ir de 3,0 a 4,2; cuando es un color calculado, da 3,6. El rojo queda exacto. El azul, el verde y el amarillo están fuera de sRGB: TaishoDS los deja exactos en la escala para pantallas de gama ancha y, en la escala sRGB, les baja la saturación a lo que esa pantalla puede mostrar. Por eso el azul da 3,70 y no 3,71.
Partir del contraste no es una idea mía. Adobe Leonardo genera escalas a partir de un contraste objetivo, y Material lo tiene resuelto dentro de su escala de tonos: según el código de su biblioteca de color, una diferencia de 50 de tono garantiza un contraste de 4,5:1 o más. De Tailwind y de Radix tomé otra cosa: los dos giran el tono de los amarillos al oscurecerlos (Tailwind de unos 102° a 54°; Radix, menos). Mi lectura es que lo hacen porque un amarillo que se oscurece con el tono fijo termina oliva. En TaishoDS, la escala de #eab308 en modo claro arranca en un tono de 97° en el paso 100 y llega a 51° en el 1000, ya cerca del naranja.
El color de marca queda exacto
Como el modo oscuro se calcula aparte, el mismo color puede caer en pasos distintos: #3b82f6 es el 500 en claro y el 600 en oscuro. En los dos aparece tal cual se escribió, y lo que cambia es la escala alrededor.
El 4,63 del principio es el peor caso de todo el barrido, y no es un caso aislado: lo dan casi 200 escalas de tonos distintos, todas en el paso 600 del modo oscuro. Una de ellas es un magenta. Ese número es el calculado; medido sobre los colores ya redondeados a los 8 bits por canal que pinta una pantalla, el mínimo es 4,59.
Dónde deja de cumplir
A veces el motor mueve el color de partida. Entre el paso 500 y el 600 hay una franja de luminosidad donde ni el texto claro ni el oscuro llegan a AA encima, y ningún paso apunta ahí. El motor corre con margen: en modo claro mueve todo color que dé entre 4,2 y 5,3 de contraste contra el fondo, y en oscuro entre 4,1 y 5,0, una zona más ancha que la franja. Si el color de marca cae ahí, se corre al borde más cercano. En el barrido pasó en 803 de las 8.192 escalas, casi 1 de cada 10. En 521 ningún texto llegaba a AA. En 276 alguno ya llegaba y el color se movió igual, por ese margen. Las 6 que quedan son el blanco y tres amarillos casi blancos, que caen fuera del rango del paso más claro (el 100 en modo claro, el 1000 en oscuro). El corrimiento más grande fue de 0,029 de luminosidad en OKLCH, menos de 3 puntos sobre 100; el editor avisa cuándo pasa y por cuánto. Lo decidí así por dos motivos, y los dos vienen de la regla del principio. Uno, que la accesibilidad es un principio en Taisho. El otro es el valor que le da a ese principio que se calcule y se acomode solo.
Lo que medí es el texto de cada paso sobre ese mismo paso. Dos colores cualesquiera de la escala, combinados entre sí, quedan fuera.
El barrido, además, es una grilla de 16 valores por canal y no los 16,7 millones de colores, y lo corrí con los grises de fábrica: un tema puede teñir los grises, y ese caso no está en estas cifras.
Lo que encontré al revisar el corrimiento
El resto del artículo, antes y después de esta sección, cuenta lo que el motor hace hoy, con sus cifras. Esta sección cuenta lo que encontré al revisarlo y lo que hará en la versión 0.17, en la que ya estoy trabajando. Las cifras nuevas están en la tabla del final, al lado de las de hoy.
Revisando el aviso que da el generador cuando corre un color encontré dos cosas en el motor, y una tercera en mi propia corrección.
Corregir puede empeorar. El borde más cercano puede ser el del paso 500, que da 4,2 contra el fondo. De las 797 escalas que se corren por caer en esa zona, 401 van a ese borde y quedan, ya corridas, por debajo de 4,5 contra el fondo. En 97 de esas 401, medidas en 8 bits, el color antes llegaba. #767676 en modo claro es una de ellas: medido en 8 bits, tiene 4,33:1 con el texto encima y 4,54:1 contra el fondo, y corrido queda en 4,72 y 4,17. Sin correrse, ese gris llega a 4,5 contra el fondo y se puede usar como texto sobre la página. Corrido, ya no: el motor le quita algo que tenía. Arregla una medida y rompe otra que yo no estaba mirando.
También mueve colores que no lo necesitan, por el margen de la sección anterior. #2563EB en claro da 4,62:1 con el texto encima y 5,17:1 contra el fondo, y se corre igual.
La tercera no está en el motor publicado: apareció en mi corrección, mientras arreglaba las otras dos. La primera versión comparaba contra el gris de texto sin redondear. Para #e22a99 en modo oscuro obtenía 4,5000, y lo que yo daba por bueno, en los 8 bits por canal que pinta el navegador, es 4,48.
En la 0.17 el motor mide los dos contrastes, texto encima y color contra el fondo, y les pide 4,5:1. Al color de partida que cae entre dos pasos, y al borde al que se correría, los mide además en 8 bits; los otros pasos de la escala siguen con el valor calculado. Un color entre dos pasos que cumple los dos queda exacto. Uno que falla alguno se corre al borde más cercano que cumpla los dos, hacia el lado que sea. Quien prefiere su color exacto aunque no llegue lo declara en el tema con seedFit: { brand: 'keep' }, y con 'shift' acepta el corrimiento. El aviso trae los dos contrastes, antes y después, y la línea para escribir.
El costo es que ese borde suele quedar más lejos: se corren menos colores, pero los que se corren se mueven más. Entre los corridos de esa zona, el corrimiento medio pasa de 0,013 a 0,030 de luminosidad, y el máximo de 0,029 a 0,059. #767676 hoy se aclara 0,019 de luminosidad y en la 0.17 se oscurece 0,037. El contraste mínimo del texto también baja, de 4,63 a 4,50, porque los colores que pasan justo ya no se mueven. Este es el mismo barrido, 4.096 colores y 8.192 escalas, con el motor de hoy y con el de la 0.17:
| Hoy | Versión 0.17 | |
|---|---|---|
| Contraste mínimo del texto, calculado | 4,632 | 4,501 |
| El mismo mínimo, medido en 8 bits | 4,588 | 4,505 |
| Pasos con el texto por debajo de 4,5 | 0 | 0 |
| Escalas con el color corrido | 803 (9,8 %) | 673 (8,2 %) |
| Escalas corridas que quedan por debajo de 4,5 contra el fondo | 401 | 0 |
| Colores entre dos pasos que quedan exactos | 0 | 130 |
| Corrimiento máximo, en luminosidad OKLCH | 0,029 | 0,059 |
Líneas de palette.ts | 351 | 424 |
Cómo probarlo
Lo más rápido es la portada del sitio. Tiene un editor de temas con un campo para escribir un hex, y la página entera se repinta con ese color, con el contraste del texto de cada paso a la vista. El editor llama a la misma función que trae el paquete, que aplica el tema en el navegador sin compilar CSS, en un proyecto que ya empaqueta sus módulos:
import { createTheme } from '@taishods/core';
createTheme({ colors: { brand: '#4F46E5' } });Para usar el sistema entero hay dos caminos. Por CDN son tres líneas en el HTML, que están en la guía de instalación, y no se instala nada. Con el paquete, el CSS sale compilado con los colores y las fuentes propias:
npm i -D @taishods/core
npx taisho init
npx taisho generatePide Node 22.18 o más nuevo.
Empecé esto porque no quería depender de acordarme de revisar el contraste en cada proyecto. Con el color, hoy ya no dependo de eso: lo elijo y el resto lo calcula el sistema. Es una sola parte de un sistema de diseño, pero es la que me convenció de que la regla se podía cumplir.
El motor está en src/lib/theme/palette.ts del repositorio y son unas 350 líneas. Si un color lo rompe, me interesa verlo: se manda por los issues del repositorio, con el hex y el modo en que falla.








