ForHosting KIT · Utilidades de desarrollo

Calcular contraste de color WCAG

Esta calculadora compara un color de primer plano con uno de fondo mediante el método de luminancia relativa de WCAG.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Devuelve la luminancia de cada color, la relación de contraste resultante e indicadores claros de conformidad AA y AAA para texto normal y grande. Puede usarla para revisar tokens de diseño, validar colores de interfaz antes de publicar o incorporar una comprobación de accesibilidad repetible a un flujo automatizado. Las entradas son colores hexadecimales explícitos, los cálculos son deterministas y los formatos no válidos producen un error útil. La herramienta web sirve para consultas individuales; cada solicitud mediante API cuesta $0.002.

Comprenda los valores que devuelve la calculadora

El resultado comienza normalizando ambas entradas como colores hexadecimales de seis dígitos en minúsculas; así, una abreviatura como #fff se presenta siempre como #ffffff. A continuación muestra la luminancia relativa del primer plano y del fondo. Esta luminancia va de cero para el negro a uno para el blanco y se obtiene linealizando los canales sRGB y ponderándolos según la distinta sensibilidad visual al rojo, verde y azul. La relación de contraste compara la luminancia más clara con la más oscura: va de 1:1 para colores idénticos a 21:1 para negro y blanco. El valor visible se redondea a dos decimales, pero cada decisión de conformidad utiliza el valor completo sin redondear. Esto evita que un resultado mostrado como 4.50 apruebe si su valor real es inferior a 4.5. La respuesta agrupa cuatro valores booleanos para texto normal y grande, adecuados tanto para mostrar a un equipo de diseño como para comprobar una política en pruebas automatizadas.

Introduzca colores válidos e interprete AA y AAA

Indique el primer plano y el fondo como colores hexadecimales de tres o seis dígitos, con almohadilla inicial o sin ella. Se aceptan valores como #123, 123, #112233 y AABBCC, que se normalizan antes del cálculo. Se rechazan nombres CSS, expresiones rgb() o hsl(), colores hexadecimales de cuatro u ocho dígitos con alfa, cadenas vacías y valores que no sean texto, porque la opacidad y la composición exigen más contexto. Para texto normal, WCAG AA requiere al menos 4.5:1 y AAA exige 7:1. Para texto grande, AA requiere 3:1 y AAA, 4.5:1. Por lo general, se considera grande el texto de al menos 18 puntos en peso normal o 14 puntos en negrita. La capacidad no inspecciona la tipografía; presenta ambas matrices para que su aplicación elija la pertinente. Un contraste aprobado es solo una parte de una revisión de accesibilidad y no demuestra por sí solo que toda la interfaz sea accesible.

Integre los resultados en diseño y entrega

Parta de los tokens reales de primer plano y fondo que utiliza el componente, no de colores tomados de una captura comprimida. En una revisión manual, compare cuerpo de texto, texto secundario, enlaces, etiquetas de botones, ayudas de formularios, indicadores de foco y estados deshabilitados con todas sus superficies. En un sistema de diseño, mantenga una matriz pequeña de parejas aprobadas y llame a la API cuando cambie la paleta. Una prueba de integración continua puede rechazar una pareja de texto cuando AA para texto normal sea falso, y permitir combinaciones decorativas o de titulares grandes bajo una regla documentada. Conserve los colores normalizados y la relación junto al resultado para facilitar su reproducción. Cada solicitud automatizada cuesta $0.002; las entradas no válidas devuelven un error. Como el algoritmo no usa red, azar ni hora actual, la misma pareja siempre genera el mismo resultado. Para transparencias, degradados, fotografías o estados interactivos, determine primero los colores renderizados o use una auditoría del navegador con contexto completo.

Revisar tokens de diseño

Compare tokens de texto y superficie antes de publicar un tema claro u oscuro.

Proteger solicitudes de cambio

Haga fallar una comprobación automática si una pareja modificada deja de alcanzar el nivel de texto requerido.

Documentar hallazgos de accesibilidad

Añada colores normalizados, luminancias y una relación reproducible a una incidencia o informe de auditoría.

¿Qué formatos de color puede utilizar?

Use colores hexadecimales de tres o seis dígitos, con almohadilla inicial o sin ella. No se admiten alfa, nombres, rgb() ni hsl().

¿Qué umbrales WCAG se aplican?

El texto normal usa 4.5:1 para AA y 7:1 para AAA. El texto grande usa 3:1 para AA y 4.5:1 para AAA.

¿La aprobación se basa en la relación redondeada?

No. La relación solo se redondea al mostrarla; los indicadores comparan el valor calculado completo con cada umbral.

¿Una pareja aprobada convierte la página en conforme con WCAG?

No. Solo confirma el contraste de los dos colores opacos indicados. Una revisión completa de accesibilidad abarca muchos otros aspectos.

¿Cuánto cuesta una solicitud mediante API?

Cada solicitud mediante API cuesta $0.002. También puede usar la calculadora web para comprobaciones interactivas individuales.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/color/contrast-ratio-wcag

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/color/contrast-ratio-wcag \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"foreground":"#111827","background":"#ffffff"}'
{
  "foreground": "#111827",
  "background": "#ffffff"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.contrast_ratio_wcag",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →