rc-a11y

Acessibilidade (a11y) — guias por tarefa

Guias práticos de acessibilidade web. Leia o guia da tarefa em references/ antes de agir — cada um traz o checklist, os exemplos de markup e os critérios de aceite. Ao revisar UI real, combine com Grep/Glob para inspecionar o markup/componentes gerados; não presuma a semântica.

Roteamento

Tarefa	Guia
Fundamentos — HTML semântico, WCAG POUR, nível AA, alt text, lang	references/foundations.md
Componentes interativos — formulários, modal, menus/tabs, foco/teclado	references/patterns.md
Teste e revisão — teclado, leitor de tela, ferramentas automáticas, contraste	references/testing.md

Princípios sempre válidos

• HTML semântico primeiro. Elemento nativo (<button>, <nav>, <label>) resolve a maioria dos casos antes de qualquer ARIA.
• ARIA só quando o HTML nativo não resolve. "No ARIA is better than bad ARIA" — ARIA incorreta é pior que ausência de ARIA.
• Tudo operável por teclado. Se uma ação só funciona com mouse/toque, é um bloqueador de acessibilidade.
• Contraste e foco visíveis. Cor não é o único indicador de estado; :focus-visible sempre perceptível.

Error Handling

• SPA renderizada no cliente pode esconder problemas do leitor de tela (DOM que só existe após JS rodar). Sem acesso ao browser, revise o markup/componentes estaticamente e diga explicitamente que a verificação com screen reader/axe ficou pendente.