Marcus Andrey Estudo
Read in English Biblioteca

Framework · Design systems · 4 min de leitura

Checklist de acessibilidade do componente

Os critérios de sucesso da WCAG 2.2 que um único componente pode cumprir ou falhar, agrupados pelos quatro princípios, para que cada componente saia com um contrato de acessibilidade testado em vez de esperar uma auditoria tela a tela.

PPerceptível

Texto alternativo, relações no código, contraste, estado não só por cor, zoom e reflow.

1.1.1 · 1.3.1 · 1.4.3 · 1.4.11
OOperável

Teclado, sem armadilha, ordem lógica, foco visível, rótulo no nome, tamanho do alvo.

2.1.1 · 2.4.7 · 2.5.8
CCompreensível

Rótulos e dicas visíveis, erros em palavras e ligados ao campo.

3.3.1 · 3.3.2
RRobusto

Nome, papel e estado lidos certo; resultados anunciados sem mover o foco.

4.1.2 · 4.1.3

Cada estado × claro e escuro × teclado, leitor de tela, 200%, 320 px = um contrato de acessibilidade

Os critérios da WCAG 2.2 que um componente consegue cumprir sozinho, agrupados pelos quatro princípios e testados em cada estado.

Use quando

  • Um componente novo está pronto para revisão e você precisa de um "passa ou não passa" antes do release.
  • Um time de produto pergunta se "o design system é acessível", e você quer uma resposta por componente, não uma promessa.
  • Uma auditoria acha o mesmo problema em muitas telas, e você suspeita que ele vem de um componente só.

Como usar

  1. Comece pelo HTML nativo e pelo padrão. Confira se o componente renderiza o elemento real (<button>, <input>, <dialog>) e, nos widgets, se segue o padrão do WAI-ARIA Authoring Practices. Anote o link do padrão. Resultado: o elemento, o padrão, ou "sem padrão, o HTML resolve".
  2. Passe pelos critérios que se aplicam. Use a lista do modelo, uma linha por critério. Pule os que não podem se aplicar a este componente e diga por quê (um Divider não tem comportamento de teclado). Resultado: uma lista de critérios, cada um marcado como "se aplica" ou não.
  3. Teste cada um em todos os estados. Padrão, hover, foco, pressionado, desabilitado, carregando, erro, nos modos claro e escuro. Contraste e foco visível costumam passar em repouso e falhar em um estado. Resultado: passa, falha ou "o produto cuida" por critério.
  4. Teste com ferramentas reais, não só com um scanner. Só teclado, um leitor de tela (VoiceOver no Mac e no iOS, NVDA no Windows), zoom de 200% e uma tela de 320 px de largura. As verificações automáticas pegam parte dos problemas; teclado e leitor de tela pegam o resto. Resultado: notas sobre o que você ouviu e para onde o foco foi.
  5. Separe garantia de responsabilidade. Para cada critério, decida se o componente garante ou se o produto precisa fazer algo (escrever um bom rótulo, não esconder o anel de foco sob um cabeçalho fixo). Resultado: o contrato de acessibilidade em duas colunas para a página de documentação.
  6. Trate falhas como bloqueio de release. Um bug num componente vai para todas as telas que o usam. Registre com o número do critério e corrija antes da próxima minor. Resultado: uma issue por falha, linkada na página de documentação.

Exemplo prático

O Text field do Harbour, antes do release 3.2 na Tidewater:

Critério O que verificamos Resultado
1.3.1 Informações e Relações Rótulo ligado com for; dica e erro ligados com aria-describedby O componente garante
1.4.3 Contraste (Mínimo) Rótulo, valor, dica e erro a 4,5:1 nos dois modos Passa, menos a dica no modo escuro (corrigida)
1.4.11 Contraste Não Textual Borda do campo e anel de foco a 3:1 contra o fundo Passa
2.4.7 Foco Visível Anel de foco em todos os estados, inclusive erro Passa
2.4.11 Foco Não Obscurecido (Mínimo) Um campo com foco não fica escondido sob a barra fixa de reserva O produto cuida
3.3.1 Identificação de Erro Erro em palavras, com aria-invalid="true" O componente garante
3.3.2 Rótulos ou Instruções Rótulo visível; placeholder nunca no lugar do rótulo O componente garante, se o produto passar um label
4.1.2 Nome, Função, Valor O leitor de tela lê "Porto de partida, campo de texto, obrigatório" Passa

Uma falha (contraste da dica no modo escuro) virou um patch. Um critério foi para a página de documentação como tarefa do produto.

Cuidado com

  • Testar só o estado padrão. Desabilitado, erro e modo escuro são onde o contraste falha.
  • Confiar no scanner. Ferramentas automáticas não sabem se o foco entrou no diálogo nem se o erro é lido junto com o campo.
  • Assumir a página inteira. Critérios como 2.4.1 Ignorar Blocos ou 1.3.2 Sequência com Significado dependem da página. Coloque-os em "o produto cuida", não marque como aprovados.
  • ARIA que promete comportamento. Um papel como menu ou tab diz ao leitor de tela que as setas funcionam. Se você não as construiu, tire o papel.

Modelo

Copie na issue de revisão do componente e preencha uma linha por critério.

Componente: ...          Versão: ...
Elemento / padrão APG: ...
Estados testados: padrão, hover, foco, pressionado, desabilitado, carregando, erro | claro, escuro

Perceptível
[ ] 1.1.1 Conteúdo Não Textual: ícones e imagens têm alternativa em texto ou estão ocultos
[ ] 1.3.1 Informações e Relações: rótulo, dica, erro e títulos expostos no código
[ ] 1.4.1 Uso de Cor: o estado não aparece só pela cor
[ ] 1.4.3 Contraste (Mínimo): texto 4,5:1 (texto grande 3:1) em todos os estados
[ ] 1.4.4 Redimensionar Texto: funciona a 200%
[ ] 1.4.10 Reflow: funciona a 320 px de largura sem rolagem lateral
[ ] 1.4.11 Contraste Não Textual: bordas, ícones, anel de foco 3:1
Operável
[ ] 2.1.1 Teclado: tudo funciona pelo teclado
[ ] 2.1.2 Sem Bloqueio do Teclado: o foco sempre consegue sair (Escape nos diálogos)
[ ] 2.4.3 Ordem do Foco: a ordem do Tab segue a ordem de leitura
[ ] 2.4.7 Foco Visível: anel de foco em todos os estados
[ ] 2.4.11 Foco Não Obscurecido (Mínimo): o produto cuida, anote as partes fixas
[ ] 2.5.3 Rótulo no Nome: o rótulo visível faz parte do nome acessível
[ ] 2.5.7 Movimentos de Arrastar: o que se arrasta também funciona sem arrastar
[ ] 2.5.8 Tamanho do Alvo (Mínimo): 24 x 24 px ou espaço suficiente
Compreensível
[ ] 3.3.1 Identificação de Erro: erro em palavras, ligado ao campo
[ ] 3.3.2 Rótulos ou Instruções: rótulo visível, dica quando precisa
Robusto
[ ] 4.1.2 Nome, Função, Valor: o leitor de tela lê nome, papel e estado
[ ] 4.1.3 Mensagens de Status: resultados anunciados sem mover o foco

Testado com: teclado / VoiceOver / NVDA / 200% / 320 px
O componente garante: ...
O produto cuida: ...
Fonte
Web Content Accessibility Guidelines (WCAG) 2.2, Recomendação do W3C (outubro de 2023). WAI-ARIA Authoring Practices Guide (W3C WAI)
Onde encontrar
Design systems na prática: Componentes acessíveis › O contrato de acessibilidade

Os links "Ver na Amazon" são de afiliado: como associado, recebo por compras qualificadas, sem custo a mais para você.

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar