Calculadora de contraste APCA

Esta calculadora de contraste APCA toma un color de texto y un color de fondo en códigos hex y devuelve el Lc con signo (contraste de luminosidad) que produce el Accessible Perceptual Contrast Algorithm, usado en el trabajo de legibilidad del borrador de WCAG 3. A diferencia del ratio de contraste WCAG 2.x más antiguo, APCA es sensible a la polaridad: texto oscuro sobre superficie clara da un Lc positivo, mientras que texto claro sobre superficie oscura da un Lc negativo de magnitud similar. Diseñadores, desarrolladores y especialistas en accesibilidad usan ese único número—junto con tablas de tamaño y peso de fuente—para decidir si el cuerpo tipográfico, las etiquetas de interfaz y los trazos no textuales siguen siendo legibles en pantallas autoiluminadas. El motor implementa las constantes públicas 0.0.98G-4g: linealización con potencia 2.4, coeficientes Y de sRGB, soft-clamp del negro y escalado SAPC BoW/WoB. Los resultados son totalmente deterministas, sin llamadas de red, muestreo ni atajos dependientes de la fecha.

Qué mide el Lc de APCA y en qué se diferencia del ratio WCAG 2

APCA predice el contraste perceptual del texto y del contenido no textual en pantallas autoiluminadas modelando la gamma del monitor, los negros suaves y la forma asimétrica en que la visión humana trata pares oscuro-sobre-claro frente a claro-sobre-oscuro. La salida es un Lc con signo que abarca aproximadamente más o menos ciento diez: por ejemplo, texto de cuerpo casi negro sobre blanco puro suele situarse cerca de Lc noventa o superior, mientras que los mismos colores invertidos producen un Lc negativo grande.

WCAG 2.x, en cambio, informa un único ratio de contraste positivo a partir de la luminancia relativa con umbrales fijos AA y AAA como 4.5 a 1 y 7 a 1; ese ratio ignora la polaridad y tiende a sobrevalorar o infravalorar ciertos pares de tonos medios que la gente realmente tiene dificultad para leer.

Esta calculadora siempre devuelve el Lc con signo, la magnitud absoluta, la etiqueta de polaridad BoW (black on white / texto oscuro sobre claro) o WoB (white on black / texto claro sobre oscuro), la Y linealizada de cada color y una banda gruesa de legibilidad derivada del Lc absoluto para un triaje rápido.

No hay rastreo de página, análisis CSS, mezcla de opacidad ni muestreo de degradados: usted aporta dos colores hex explícitos y recibe un objeto reproducible apto para puertas de tokens de diseño, tickets de accesibilidad y revisiones automatizadas de paleta que deben citar un Lc numérico en lugar de una opinión subjetiva sobre una captura de pantalla.

Cómo se leen las entradas hex y por qué la ruta 0.0.98G-4g es determinista

Ambos valores deben ser hex: almohadilla inicial opcional, tres dígitos que se expanden a seis o seis dígitos completos, sin distinguir mayúsculas. Sufijos alfa, funciones rgb(), funciones hsl(), colores CSS con nombre y enteros sueltos se rechazan con un mensaje que nombra el campo y muestra lo recibido, para que un token erróneo nunca se convierta en un fail-open silencioso. Cada color se limita a treinta y dos caracteres para mantener la validación barata y bloquear pegados accidentales.

Tras el análisis, cada canal se eleva a la potencia 2.4 tras dividir por doscientos cincuenta y cinco, y se combina con los coeficientes sRGB de APCA 0.2126729, 0.7151522 y 0.0721750 para formar Y. Los valores Y casi negros en o por debajo de 0.022 reciben el soft-clamp para no penalizar en exceso el negro puro.

Cuando la Y del fondo es mayor que la del texto, la rama BoW aplica exponentes 0.56 y 0.57 con escala 1.14 y desplazamiento 0.027; en caso contrario la rama WoB usa 0.65 y 0.62 y devuelve un Lc negativo. Deltas de luminancia extremadamente pequeñas se recortan a cero.

Dónde encajan las comprobaciones APCA en design systems, modo oscuro y WCAG 3

Los equipos de producto recurren a APCA cuando una paleta de marca que superó WCAG 2 AA sigue viéndose turbia en modo oscuro, cuando el texto gris medio sobre superficies suaves falla pruebas humanas de legibilidad, o cuando las partes interesadas piden números Lc alineados con las discusiones del borrador de WCAG 3 en lugar del ratio antiguo solo.

Los ingenieros conectan el mismo contrato a comprobaciones de pull request que bloquean un cambio de token si el Lc absoluto de los colores de cuerpo primario cae por debajo de un umbral del equipo como sesenta, o registran valores WoB para titulares hero del tema oscuro que se sitúan a propósito más cerca de la superficie. QA y especialistas en accesibilidad adjuntan Lc con signo y polaridad a los informes de error para que los desarrolladores corrijan el par exacto en lugar de adivinar desde una captura.

Los equipos de contenido y marketing verifican que los códigos hex de campaña siguen superando las bandas mínimas de cuerpo al colocarse sobre fondos claros u oscuros del sitio. Combínelo con el verificador de ratio WCAG 2 cuando aún necesite documentación AA/AAA, y con herramientas de conversión de color cuando necesite intermedios RGB o HSL antes de calcular el Lc.