/revisão-de-acessibilidade
Se você encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, veja CONNECTORS.md.
Audite um design ou página para conformidade com a acessibilidade WCAG 2.1 AA.
Uso
/revisão-de-acessibilidade $ARGUMENTOS
Auditar acessibilidade: @$1
Referência Rápida WCAG 2.1 AA
Perceptível
- 1.1.1 Conteúdo não textual tem texto alternativo
- 1.3.1 Informação e estrutura transmitidas semanticamente
- 1.4.3 Taxa de contraste >= 4.5:1 (texto normal), >= 3:1 (texto grande)
- 1.4.11 Contraste não textual >= 3:1 (componentes de UI, gráficos)
Operável
- 2.1.1 Toda funcionalidade disponível via teclado
- 2.4.3 Ordem de foco lógica
- 2.4.7 Indicador de foco visível
- 2.5.5 Alvo de toque >= 44x44 pixels CSS
Compreensível
- 3.2.1 Previsível ao focar (sem mudanças inesperadas)
- 3.3.1 Identificação de erros (descrever o erro)
- 3.3.2 Rótulos ou instruções para entradas
Robusto
- 4.1.2 Nome, função e valor para todos os componentes de UI
Problemas Comuns
- Contraste de cor insuficiente
- Rótulos de formulário ausentes
- Sem acesso por teclado a elementos interativos
- Texto alternativo ausente em imagens significativas
- Armadilhas de foco em modais
- Marcos ARIA ausentes
- Mídia com reprodução automática sem controles
- Limites de tempo sem opções de extensão
Abordagem de Teste
- Varredura automatizada (detecta ~30% dos problemas)
- Navegação exclusiva por teclado
- Teste com leitor de tela (VoiceOver, NVDA)
- Verificação de contraste de cor
- Zoom para 200% — o layout quebra?
Saída
## Auditoria de Acessibilidade: [Nome do Design/Página]
**Padrão:** WCAG 2.1 AA | **Data:** [Data]
### Resumo
**Problemas encontrados:** [X] | **Críticos:** [X] | **Graves:** [X] | **Menores:** [X]
### Descobertas
#### Perceptível
| # | Problema | Critério WCAG | Gravidade | Recomendação |
|---|----------|---------------|-----------|---------------|
| 1 | [Problema] | [1.4.3 Contraste] | 🔴 Crítico | [Correção] |
#### Operável
| # | Problema | Critério WCAG | Gravidade | Recomendação |
|---|----------|---------------|-----------|---------------|
| 1 | [Problema] | [2.1.1 Teclado] | 🟡 Grave | [Correção] |
#### Compreensível
| # | Problema | Critério WCAG | Gravidade | Recomendação |
|---|----------|---------------|-----------|---------------|
| 1 | [Problema] | [3.3.2 Rótulos] | 🟢 Menor | [Correção] |
#### Robusto
| # | Problema | Critério WCAG | Gravidade | Recomendação |
|---|----------|---------------|-----------|---------------|
| 1 | [Problema] | [4.1.2 Nome, Função, Valor] | 🟡 Grave | [Correção] |
### Verificação de Contraste de Cor
| Elemento | Primeiro Plano | Fundo | Proporção | Necessário | Passa? |
|----------|----------------|-------|-----------|------------|--------|
| [Texto do corpo] | [cor] | [cor] | [X]:1 | 4.5:1 | ✅/❌ |
### Navegação por Teclado
| Elemento | Ordem de Tab | Enter/Espaço | Escape | Setas |
|----------|--------------|--------------|--------|-------|
| [Elemento] | [Ordem] | [Comportamento] | [Comportamento] | [Comportamento] |
### Leitor de Tela
| Elemento | Anunciado Como | Problema |
|----------|----------------|----------|
| [Elemento] | [O que o SR diz] | [Problema, se houver] |
### Correções Prioritárias
1. **[Correção crítica]** — Afeta [quem] e bloqueia [o quê]
2. **[Correção grave]** — Melhora [o quê] para [quem]
3. **[Correção menor]** — Bom ter
Se Conectores Estiverem Disponíveis
Se ~~ferramenta de design estiver conectada:
- Inspecione valores de cor, tamanhos de fonte e alvos de toque diretamente do Figma
- Verifique papéis ARIA de componentes e comportamento do teclado na especificação de design
Se ~~rastreador de projeto estiver conectado:
- Crie tickets para cada descoberta de acessibilidade com gravidade e critério WCAG
- Vincule descobertas a épicos existentes de correção de acessibilidade
Dicas
- Comece com contraste e teclado — Esses detectam os problemas mais comuns e impactantes.
- Teste com tecnologia assistiva real — Minha auditoria é um ótimo começo, mas testes manuais com VoiceOver/NVDA detectam coisas que não consigo.
- Priorize pelo impacto — Corrija primeiro os problemas que bloqueiam usuários, depois os de polimento.