En el desarrollo web moderno, la accesibilidad (accessibility, a11y) se parece demasiado a ir al dentista: todo el mundo sabe que es vital, pero lo pospone hasta el último segundo. La mayoría de los equipos solo se acuerda de los estándares WCAG cuando el departamento legal recibe una reclamación de un regulador o cuando un gran cliente corporativo exige un certificado de cumplimiento.
Entonces cunde el pánico y los desarrolladores empiezan a colgar a lo loco atributos aria-label y role="button" en simples etiquetas <div>, cruzando los dedos para que los lectores de pantalla se aclaren. El resultado es un culto cargo clásico: sobre el papel los atributos están ahí, pero una persona ciega o con movilidad reducida es físicamente incapaz de enviar el formulario o cerrar una ventana emergente con la tecla Escape.
Para romper este círculo vicioso, la consultora británica líder en diseño inclusivo ha publicado la librería abierta TetraLogical Accessible Components Library (el código fuente está en su repositorio de GitHub). Su autor es el reconocido experto en accesibilidad digital Craig Abbott.
Veamos por qué esta librería merece toda la atención de cualquier desarrollador frontend, tanto si programas en React, Vue o Svelte como si trabajas en JavaScript puro.
Ocho patrones básicos de UI sin dependencias de frameworks
La primera y más valiosa decisión arquitectónica del equipo de TetraLogical es renunciar por completo a frameworks y runtimes externos. La librería no depende de React, Tailwind, Redux ni pesados polyfills. Todos los componentes están escritos en HTML5 semántico nativo, CSS limpio y Vanilla JavaScript conciso.
El paquete inicial incluye ocho patrones interactivos fundamentales que cubren el 90% de las interfaces de usuario:
- Accordion (acordeón): secciones desplegables con cambio correcto de estado mediante las flechas arriba/abajo.
- Alerts (alertas): mensajes del sistema con regiones vivas
aria-live="polite". - Breadcrumbs (migas de pan): ruta de navegación marcada con la etiqueta
<nav aria-label="...">. - Disclosure (desplegable): botón compacto para mostrar y ocultar contenido adicional.
- Modal Dialog (diálogo modal): ventana aislada con retención estricta del foco (Focus Trap) y bloqueo del fondo.
- Pagination (paginación): selector de páginas que anuncia la página actual mediante
aria-current="page". - Tabs (pestañas): sistema de pestañas con la relación correcta de roles
tablist,tab,tabpanely navegación por teclado con flechas. - Tooltip (información emergente): ayuda contextual que se abre al recibir el foco y se cierra con la tecla Escape. Si te interesa la evolución de los tooltips nativos en navegadores, échale un vistazo también a nuestro análisis sobre Firefox 157 y el estilizado nativo de tooltips.
Anatomía de una ventana modal accesible en HTML y JS puros
Asomémonos a la implementación de la ventana modal. En la inmensa mayoría de librerías de UI de terceros, un modal es un div pesado plagado de manejadores de eventos. TetraLogical toma como base el elemento nativo HTML5 <dialog> combinado con una gestión cuidada del foco:
<!-- Marcado de una ventana de diálogo accesible -->
<dialog id="confirm-modal" aria-labelledby="modal-title" aria-describedby="modal-desc" class="c-modal">
<div class="c-modal__inner">
<h2 id="modal-title">Confirmar eliminación de cuenta</h2>
<p id="modal-desc">Esta acción es irreversible. Todos tus proyectos se eliminarán para siempre.</p>
<div class="c-modal__actions">
<button type="button" class="btn btn--danger" id="confirm-delete">Eliminar para siempre</button>
<button type="button" class="btn btn--secondary" id="cancel-delete">Cancelar</button>
</div>
</div>
</dialog>
Y así es el módulo mínimo en JavaScript que controla el foco:
// Controlador de ventana modal con trampa de foco
class AccessibleModal {
constructor(dialogElement) {
this.dialog = dialogElement;
this.previousFocus = null;
// Cierre con la tecla Escape devolviendo el foco
this.dialog.addEventListener('keydown', (e) => {
if (e.key === 'Escape') {
e.preventDefault();
this.close();
}
});
}
open() {
this.previousFocus = document.activeElement;
this.dialog.showModal(); // API nativa del navegador con bloqueo del fondo
// Movemos el foco al primer elemento interactivo
const firstFocusable = this.dialog.querySelector('button, [href], input, [tabindex="0"]');
if (firstFocusable) firstFocusable.focus();
}
close() {
this.dialog.close();
// ¡Devolvemos el foco al elemento que abrió la ventana!
if (this.previousFocus && typeof this.previousFocus.focus === 'function') {
this.previousFocus.focus();
}
}
}
Fíjate en el método close(): devolver el foco al elemento que abrió el modal es un requisito clave de WCAG 2.2 que olvidan 8 de cada 10 desarrolladores. Sin eso, al cerrar la ventana el foco del lector de pantalla salta al principio de la página y el usuario ciego pierde por completo el contexto de dónde estaba trabajando.
Automatización del 97% de los escenarios de accesibilidad con Playwright y Cucumber
La parte más impresionante de ingeniería en el proyecto de TetraLogical no es el código de los componentes en sí, sino su sistema de pruebas.
Históricamente, probar la accesibilidad se consideraba un proceso exclusivamente manual: había que sentar a un especialista con un lector de pantalla activo (NVDA en Windows, VoiceOver en macOS) e ir haciendo clic a mano por toda la interfaz. Los linters automáticos como axe-core solo cazan fallos básicos de contraste y atributos olvidados (no más del 30–40% de los problemas).
El equipo de Craig Abbott fue mucho más allá: describió los requisitos de comportamiento de cada componente en lenguaje legible Gherkin con Cucumber y automatizó su ejecución en navegadores reales usando Playwright.
Ejemplo de escenario de prueba en Gherkin:
Feature: Navegación por teclado en la ventana modal
Scenario: Cerrar la ventana con la tecla Escape devuelve el foco
Given la ventana modal está abierta tras hacer clic en el botón "Eliminar"
When el usuario pulsa la tecla "Escape"
Then la ventana modal debe ocultarse
And el foco de entrada debe volver al botón "Eliminar"
Gracias a esta combinación, los autores lograron automatizar el 97% de todos los criterios de aceptación de WCAG 2.2 para sus componentes. Los tests verifican el orden de tabulación, el manejo de las flechas, la visibilidad del foco y la correcta transmisión de roles a los lectores de pantalla en motores reales de Chromium, WebKit y Firefox.
Cómo usarla en tus proyectos
La librería se distribuye bajo la permisiva licencia MIT. Puedes aprovecharla de dos maneras:
- Como especificación de referencia para aprender: cuando diseñes componentes para tu sistema de diseño corporativo en React, Vue o Angular, abre el repositorio de TetraLogical y copia directamente la estructura HTML correcta, la lógica de captura de teclado y los atributos ARIA.
- Como base ligera para proyectos reales: conecta los scripts y estilos nativos directamente y adáptalos a tu marca con variables CSS, sin cargar con el peso del runtime de un framework.
El diseño inclusivo no es caridad ni burocracia. Es una muestra de madurez técnica del equipo y de respeto hacia cada persona que usa tu producto.


