Saltar al contenido

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 oscuroaxe 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 tocael 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 tecladoel 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 movimientoprefers-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 RTLel 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 overlaysModal 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

La automatización encuentra mucho, pero no encuentra que un nombre accesible sea correcto aunque exista, ni que el orden en que se anuncia algo tenga sentido. Eso solo lo encuentra alguien escuchando. Hoy hay 0 de 56 componentes con pasada registrada, y cada página lo dice en su propia sección en vez de callarlo.

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 placeholder no es una etiqueta: desaparece al escribir. Conviene un <label for> real, con el texto de ayuda y el error atados mediante aria-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-24 en 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.
html
<!-- 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.