Accesibilidad
Qué garantiza el sistema, cómo está verificado y qué sigue a cargo del proyecto. Lo que no está verificado se dice aquí como un límite.
El enfoque
La accesibilidad no es una capa que se agrega al final: sale del mismo motor que emite el CSS. El contraste se calcula, no se elige a ojo. El foco visible no depende de que alguien se acuerde de estilarlo. El espejado RTL no depende de migrar clases. Cuando una garantía se puede mover al motor o a un test, se mueve — lo que queda librado a la disciplina se rompe.
La contracara es que el sistema es honesto sobre su límite: un DS puede garantizar sus componentes, no tu aplicación. La mitad de abajo de esta página es sobre eso.
Qué garantiza el sistema
| Qué garantiza | Cómo se verifica |
|---|---|
| Sin violaciones de axe en cada página de componente, en reposo, en tema claro y oscuro | axe se corre sobre cada página, en tema claro y oscuro, sin abrir menús, diálogos ni listas |
| Contraste de texto AA sobre el fondo que le toca | el motor calcula en OKLCH el par color/contraste de cada tema y se comprueba con un test automático |
| Foco visible siempre; en botones y controles, solo con teclado | el CSS de los componentes usa :focus-visible, nunca :focus plano; en los campos de texto el navegador también lo aplica al hacer clic |
| Se mueve menos si se pidió menos movimiento | prefers-reduced-motion: reduce apaga las transiciones y deja quietos el skeleton, la barra indeterminada y el halo del Badge, emitido globalmente |
| La UI se espeja entera en RTL | el CSS usa propiedades lógicas (inicio y fin) para el espaciado y la alineación; las físicas (izquierda y derecha) quedan sólo en posiciones por coordenadas o nombradas por lado (flotantes, avisos, paleta de comandos, indicador de presencia del Avatar), y en los flotantes el JS calcula las coordenadas ya espejadas |
| Foco atrapado y devuelto en overlays | Modal y AlertDialog usan <dialog> nativo; se prueba con interacción real en Chromium, Firefox y WebKit |
El objetivo declarado es WCAG 2.2 nivel AA. Cada componente publica su propia declaración —el patrón de la WAI-ARIA APG que implementa, las teclas que agrega y el ARIA que aporta— en la sección Accesibilidad de su página. Hoy son 56 componentes declarados, 21 de ellos sobre un patrón de la APG, con 207 afirmaciones de ARIA y 62 atajos de teclado propios repartidos en 24 componentes.
Los límites
Ningún componente pasó todavía por un lector de pantalla real
Tampoco existe todavía un ACR/VPAT formal. La declaración por componente es exactamente el insumo con el que se redacta, pero mientras no esté firmado, no debe tomarse como uno.
Tampoco se probó en un iPhone ni en un iPad reales: WebKit de escritorio (Playwright) no reemplaza a Safari en iOS con VoiceOver.
Cómo está probado
Cuatro capas, de la más barata a la más cara. Ninguna reemplaza a la siguiente:
- axe en cada render: una revisión automática de cada componente. Encuentra mucho, pero no todo.
- Interacción real en 3 navegadores: foco, teclado y overlays apilados en Chromium, Firefox y WebKit, con clics de verdad y no con eventos sintéticos.
- Combinaciones difíciles: overlays anidados, listas virtualizadas en contenedores chicos, pantallas de 375px con todos los modos. Es donde aparecen los problemas que una demo con un componente solo esconde.
- Lectores de pantalla, a mano: es la capa que todavía no se hizo en ningún componente (ver arriba).
Lo que queda a cargo del proyecto
Los componentes traen el comportamiento; el contenido lo pone quien arma la página, y ahí es donde se pierde la accesibilidad en la práctica. Lo mínimo:
- Etiquetar los campos. Un
placeholderno es una etiqueta: desaparece al escribir. Conviene un<label for>real, con el texto de ayuda y el error atados mediantearia-describedby. El Field trae esa estructura armada. - Los botones de solo ícono necesitan nombre. Sin texto visible, se le pasa un
aria-label. - Declarar el idioma en
<html lang>: es lo que decide cómo pronuncia el lector. - No se saltan niveles de encabezado. El sistema te da
las escalas tipográficas sueltas justamente para que el tamaño no te obligue a elegir mal el
nivel:
type-heading-24en un<h3>es perfectamente válido. - Al tematizar, verificar el contraste. El motor lo garantiza para las semillas que recibe, pero un color forzado a mano por fuera del sistema no pasa por ese cálculo.
<!-- Mal: el placeholder se va cuando se escribe -->
<div class="ts input size-md variant-default" data-ts-input>
<input class="ts input-field" type="email" placeholder="Correo" />
</div>
<!-- Bien: label real, atada al control, con su ayuda -->
<label for="correo" class="ts input-label">Correo</label>
<div class="ts input size-md variant-default" data-ts-input>
<input id="correo" class="ts input-field" type="email" aria-describedby="correo-ayuda" />
</div>
<div id="correo-ayuda" class="ts input-hint variant-default">
<span>Se envía la confirmación a este correo</span>
</div>
<!-- Botón de solo ícono: sin aria-label no tiene nombre -->
<button class="ts button size-md variant-ghost" aria-label="Cerrar">
<svg class="ts icon size-16" aria-hidden="true"><use href="taisho/taisho.icons.svg#ts-x"></use></svg>
</button>Reportar un problema
Un fallo de accesibilidad se trata como un bug funcional, no como una mejora. Si se encuentra uno, lo útil es: qué componente, con qué lector y navegador, qué se esperaba escuchar y qué se escuchó. Si contradice una afirmación publicada en la sección Accesibilidad del componente, conviene indicarlo — esa afirmación es la que hay que corregir primero.