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 read • Q2BSTUDIO Team

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.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat