Crea un verificador de contraste de colores con HTML, CSS y JavaScript

Crear un verificador de contraste de colores con HTML, CSS y JavaScript para garantizar la accesibilidad y legibilidad de tu sitio web.

2 dic 2025 • 5 min de lectura • Equip Q2BSTUDIO

Create a Color Contrast Checker with HTML, CSS and JavaScript

En Q2BSTUDIO, empresa especializada en desarrollo de software y aplicaciones a medida, inteligencia artificial, ciberseguridad y servicios cloud, sabemos que la accesibilidad visual es clave para ofrecer experiencias inclusivas y profesionales. Este artículo explica de forma práctica qué es el contraste de color, cómo calcularlo y cómo construir un verificador de contraste con HTML, CSS y JavaScript, además de mostrar cómo estos conocimientos encajan con servicios como aplicaciones a medida, software a medida, ia para empresas y servicios cloud aws y azure.

Qué es el contraste de color y por qué importa: el contraste de color describe la diferencia de brillo entre el color del primer plano y el fondo. En términos simples, determina lo fácil que es para el ojo humano distinguir texto o imágenes sobre un fondo coloreado. Las pautas WCAG recomiendan una ratio mínima de 4.5 a 1 para texto normal y 3 a 1 para texto grande. El texto grande se define como 24px o mayor en fuentes de peso normal o 18.66px o mayor en fuentes en negrita. Un contraste moderado y adecuado además reduce la fatiga visual y mejora la usabilidad para personas con visión reducida.

Cálculo de la ratio de contraste: la fórmula usada por WCAG es ratio = (L1 + 0.05) / (L2 + 0.05) donde L1 es la luminancia relativa del color más claro y L2 la del más oscuro. Para obtener la luminancia relativa se parte de los valores RGB en 0 a 255, se normalizan dividiendo entre 255 y luego se aplica una linearización: si el componente normalizado es menor o igual que 0.03928 se divide entre 12.92, en caso contrario se aplica la potencia de exponente 2.4 tras ajustar con 1.055 y 0.055. Finalmente la luminancia relativa se calcula con la fórmula L = 0.2126 * r + 0.7152 * g + 0.0722 * b usando los valores linearizados r g b.

Ejemplo práctico: si conviertes un color hexadecimal a sus componentes R G B, normalizas y linearizas según la regla anterior y luego aplicas la combinación ponderada, obtendrás L1 y L2 que permiten calcular la ratio. Ratios mayores indican mejor contraste y cumplimiento de niveles AA o AAA de WCAG.

Cómo construir el verificador con HTML CSS y JavaScript en alto nivel: la interfaz incluye selectores de color para primer plano y fondo, campos para mostrar y editar los valores hex, un área de vista previa que aplica ambos colores, un bloque que muestra la ratio calculada y una zona de resultados que indica paso o fallo para AA y AAA en texto normal y grande. Con CSS se definen estilos básicos de presentación, espaciado y estados para pass y fail, y con JavaScript se sincronizan inputs y se valida el formato hexadecimal antes de calcular.

Validación y sincronización: al permitir edición manual del campo hex se recomienda normalizar la entrada añadiendo el símbolo numeral si falta y validar que el valor tenga 3 o 6 caracteres hexadecimales. Si el valor no es válido se muestra un mensaje de error y se evita el cálculo hasta que se corrija. Cuando el usuario usa el selector de color nativo del navegador se sincroniza el campo de texto y se actualiza la vista previa.

Obtención de la ratio: existen dos enfoques comunes. Uno consiste en implementar en el cliente el cálculo de luminancia y ratio siguiendo las fórmulas WCAG, lo que evita dependencia externa. El otro usa una API como la de WebAIM enviando fcolor sin el numeral y bcolor sin el numeral por ejemplo https://webaim.org/resources/contrastchecker/?fcolor=0000FF&bcolor=FFFFFF&api y procesando el JSON de respuesta que incluye la ratio y estados para AA AALarge AAA AAALarge. En ambos casos se actualizan los textos de resultado y las clases CSS para mostrar pass o fail con estilos diferenciados.

Resumen del flujo en JavaScript: 1 obtener valores actuales de color primer plano y fondo 2 validar y normalizar hex 3 actualizar vista previa con estilos inline 4 calcular luminancias o llamar a API 5 leer ratio y estados 6 actualizar la interfaz mostrando contraste numérico y si cumple WCAG AA y AAA para texto normal y grande 7 gestionar errores de red o entrada con mensajes claros.

Buenas prácticas de diseño accesible: utiliza contrastes que superen la ratio mínima recomendada, comprueba combinaciones de colores en distintos tamaños de texto y pesos, y no relies únicamente en color para transmitir información. Reducir el contraste excesivo no siempre es negativo, pero busca equilibrio para disminuir la fatiga visual. Integra pruebas automatizadas en tus pipelines y considera auditorías de accesibilidad cuando lances productos al mercado.

Cómo encaja esto con los servicios de Q2BSTUDIO: al desarrollar aplicaciones a medida y software a medida nosotros incluimos criterios de accesibilidad y buenas prácticas de contraste desde las primeras etapas del diseño para asegurar producto inclusivo. Si tu proyecto requiere integración en la nube podemos desplegar soluciones seguras en servicios cloud aws y azure o asesorar en arquitectura escalable. Para proyectos que incorporan inteligencia artificial y agentes IA ofrecemos soluciones de ia para empresas que mejoran la experiencia de usuario sin sacrificar accesibilidad. Conecta el verificador de contraste en flujos de diseño y validación automatizados o con dashboards de inteligencia de negocio como power bi para medir y reportar cumplimiento.

Si buscas desarrollar una aplicación accesible y a medida consulta nuestras opciones de desarrollo en desarrollo de aplicaciones y software multiplataforma y descubre cómo integrar capacidades de inteligencia artificial en tu producto en servicios de inteligencia artificial. También ofrecemos auditorías de ciberseguridad y pentesting para garantizar que tus aplicaciones seguras y accesibles se mantengan protegidas frente a amenazas.

Palabras clave relevantes: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi. Incluir estas prácticas mejora tanto la experiencia de usuario como el posicionamiento y la calidad del producto final.

Conclusión: crear un verificador de contraste es una forma práctica de garantizar cumplimiento WCAG y mejorar la accesibilidad de tus productos digitales. En Q2BSTUDIO combinamos diseño accesible, desarrollo a medida, soluciones cloud y capacidades de IA para ofrecer proyectos completos y seguros. Si quieres que te ayudemos a integrar accesibilidad y automatización en tu proyecto contacta con nosotros para una consultoría personalizada.

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.

Live Chat