Design systems · Passo 3 · 9 min de leitura
Componentes acessíveis
A acessibilidade construída num componente chega a todas as telas que o usam; um erro nele também. Comece pelo HTML nativo, siga os padrões do WAI-ARIA Authoring Practices quando eles existem, e escreva o que o componente garante e o que continua sendo do produto. Com o Button, o Text field e o Ticket card do Harbour.
Um design system multiplica tudo o que você coloca nele, inclusive os bugs. Corrija uma vez a ordem de foco do diálogo do Harbour e todos os produtos recebem a correção na próxima versão. Publique um campo de texto cujo erro não é anunciado, e duzentos formulários têm o mesmo problema até sexta-feira. Por isso a acessibilidade mora no próprio componente, escrita como um contrato e testada antes da release, não auditada tela por tela depois.
O que você vai conseguir fazer depois de ler:
- Começar um componente pelo HTML nativo e só usar ARIA onde o HTML não chega
- Usar os padrões do WAI-ARIA Authoring Practices para teclado e papéis
- Construir um campo de texto cujo rótulo, dica e erro chegam ao leitor de tela
- Escrever o contrato de acessibilidade de um componente: o que ele garante e o que fica com o produto
1. Comece pelo HTML
Fundamentos de acessibilidade cobre o básico: perceptível, operável, compreensível, robusto. Para componentes, duas regras do W3C vêm primeiro.
- A primeira regra de uso do ARIA: se você pode usar um elemento ou atributo HTML nativo que já tem a semântica e o comportamento de que precisa, em vez de adaptar um elemento e acrescentar um papel, estado ou propriedade ARIA para torná-lo acessível, faça isso (W3C, Using ARIA).
- Nenhum ARIA é melhor que ARIA ruim. O Authoring Practices Guide começa por aí: ARIA incorreto representa errado a experiência visual, com efeitos que podem ser devastadores para quem usa leitor de tela (APG, Read Me First).
Por isso o Button do Harbour gera um <button> de verdade, que já traz foco, Enter e Espaço de graça. O Text field gera um <input> de verdade com um <label> de verdade. O ARIA só entra no que o HTML não tem elemento para fazer, como a lista aberta de um combobox.
2. Siga os padrões que existem
O WAI-ARIA Authoring Practices Guide (APG) descreve, para cada widget comum, o comportamento de teclado que as pessoas esperam e os papéis, estados e propriedades que vêm junto. O Harbour liga cada componente ao seu padrão, ou explica por que não existe um:
| Componente do Harbour | Padrão do APG | Teclado | Papéis, estados, propriedades |
|---|---|---|---|
| Button | Button | Enter e Espaço acionam | Um <button> de verdade; aria-disabled="true" enquanto carrega; aria-pressed só em botões de alternância |
| Text field | Nenhum: o HTML nativo é o padrão | Tab para entrar, digitar, Tab para sair | <label for>; dica e erro ligados com aria-describedby; aria-invalid="true" no erro; autocomplete |
| Ticket card | Nenhum: um card é um grupo, não um widget | O Tab passa só pelas ações dele | A rota é um título; nenhum papel no card; um controle por ação |
| Seletor de porto | Combobox | ↓ abre a lista e entra nela, Esc fecha | role="combobox", aria-expanded, aria-controls, aria-activedescendant |
| Diálogo de cancelar reserva | Dialog (Modal) | O Tab fica dentro; Esc fecha; o foco volta para o botão que abriu | role="dialog", aria-modal="true", aria-labelledby apontando para o título |
| Detalhes do bilhete | Disclosure | Enter e Espaço mostram e escondem | Um botão com aria-expanded true ou false |
O que os padrões pedem, nos componentes do Harbour:
- Padrão Button. Espaço e Enter acionam. Quando a ação do botão não está disponível, o botão recebe
aria-disabledcom valor true, e é assim que funciona o estado de carregando do Harbour. Para botões de alternância,aria-pressed, e um aviso que vale copiar na sua documentação: é essencial que o rótulo de um botão de alternância não mude quando o estado muda (APG, Button). - Padrão Dialog (Modal). O foco entra no diálogo quando ele abre, Tab e Shift+Tab ficam dentro dele, Esc fecha. O contêiner tem
role="dialog",aria-modal="true"e um nome que vem do título visível (APG, Dialog (Modal)). O diálogo "Cancelar reserva" do Harbour faz tudo isso, para nenhum time de produto precisar fazer. - Padrão Combobox. O seletor de porto: a seta para baixo abre a lista e entra nela, Esc fecha, e o foco do DOM fica no campo enquanto
aria-activedescendantaponta para a opção destacada (APG, Combobox). É o padrão mais difícil da lista, e é exatamente o tipo de coisa que um sistema deve construir uma vez só. - Padrão Disclosure. "Ver detalhes" num bilhete: um botão com
aria-expandedtrue ou false (APG, Disclosure).
3. Quando não há padrão: o Text field
Não existe padrão do APG para campo de texto, porque o HTML já tem um. O trabalho está em ligar as partes.
<label for>; a dica e o erro estão ligados ao campo com aria-describedby, então um leitor de tela lê os três quando o campo recebe o foco; aria-invalid="true" diz que o valor está errado. O erro vem em palavras com um ícone, não só numa borda vermelha. Navegue pelos dois campos com Tab.- Um rótulo visível, ligado com
for. O GOV.UK Design System pede rótulos visíveis, acima do campo, curtos e só com a primeira letra maiúscula, e avisa para não usar placeholder no lugar do rótulo, porque ele some quando a pessoa digita e nem todo leitor de tela lê (GOV.UK, Text input; W3C, Labeling controls). - Dica e erro ligados com
aria-describedby, para serem lidos junto com o rótulo (MDN, aria-describedby). aria-invalid="true"quando o valor está errado (MDN, aria-invalid), e o erro em palavras, não só numa borda vermelha (W3C, Understanding 3.3.1 Error Identification).autocompletecom o valor certo, para o navegador conseguir preencher. O GOV.UK recomenda pelo mesmo motivo.
O componente monta tudo isso a partir de três props, label, hint e error. O time de produto nunca escreve um id ou um aria-describedby à mão, então não tem como errar.
4. Quando não há padrão: o Ticket card
Um card não é um widget; é um grupo de conteúdo. Ele não precisa de papel. O que ele precisa:
- Um título para a rota, para quem usa leitor de tela pular de bilhete em bilhete. O nível do título é uma prop, porque só a página conhece a própria estrutura.
- Um controle por ação, numa ordem que faz sentido. O Tab vai para "Ver bilhete", depois "Pedir reembolso", e para mais nenhum lugar.
- O status em palavras. "Cancelado" é texto dentro do selo, não só uma borda coral (W3C, Understanding 1.4.11, para o contraste da borda).
O capítulo de Heydon Pickering sobre cards mostra o caso de um card clicável inteiro: mantenha um link de verdade dentro dele e estique esse link sobre o card com um pseudoelemento, em vez de embrulhar tudo num link (Pickering, Inclusive Components: Cards). O Ticket card tem duas ações, então não faz isso: um link no card inteiro esconderia o segundo botão.
5. O contrato de acessibilidade
Escreva, na página de documentação de cada componente, o que o componente garante e o que o produto ainda precisa fazer. O do Button do Harbour:
| O componente garante | O produto cuida de |
|---|---|
Um <button> de verdade; Enter e Espaço funcionam |
Um rótulo que diz o que acontece: "Reservar travessia", não "Clique aqui" |
| Um anel de foco de 3 px, com 3:1 ou mais nos dois modos | Não escondê-lo sob um cabeçalho fixo |
| Um alvo de 44 px (32 px no compacto), acima do mínimo de 24 px da WCAG (Understanding 2.5.8) | Espaço suficiente entre botões numa linha |
| Carregando mantém o foco; cliques ignorados | Anunciar o resultado com uma mensagem de status |
| Contraste do texto medido em todos os estados | Não sobrescrever as cores |
Depois teste o componente, não só as telas: só com teclado, com leitor de tela (VoiceOver no Mac e no iOS, NVDA no Windows), com zoom de 200% e com 320 px de largura. Um componente que passa é uma coisa a menos para conferir em cada página. O curso gratuito Digital Accessibility Foundations, do W3C, é um bom começo para um time inteiro.
6. Erros comuns
- Um
divcom um evento de clique em vez de um<button>. - Papéis ARIA em elementos que já têm esse papel, ou papéis que prometem um comportamento de teclado que ninguém construiu.
- Placeholder no lugar do rótulo.
- Erros só em vermelho, e não ligados ao campo.
- Um diálogo que não leva o foco para dentro, ou não devolve quando fecha.
- Deixar o contrato de acessibilidade sem escrever, e os times de produto sem saber o que sobra para eles.
7. Vocabulário
| Termo | Significado |
|---|---|
| ARIA | Atributos que dizem à tecnologia assistiva o que um elemento é e em que estado está |
| APG | O WAI-ARIA Authoring Practices Guide: os padrões do W3C para teclado e papéis |
| Papel (role) | O que um elemento é para a tecnologia assistiva: botão, diálogo, combobox |
| Nome acessível | Como o leitor de tela chama um controle, normalmente a partir do rótulo |
aria-describedby |
Liga um texto extra, como uma dica ou um erro, a um controle |
| Contrato de acessibilidade | O que um componente garante, e o que o produto que o usa ainda precisa fazer |
8. Experimente (sem ferramentas)
- Abra um formulário num produto que você usa. Deixe o mouse de lado.
- Chegue com Tab a um campo com erro. O erro está ao lado dele, em palavras? Diz como corrigir?
- Abra um diálogo. Onde está o foco? Aperte Esc. Para onde vai o foco?
Perguntas para refletir: Quais desses problemas sumiriam se fossem corrigidos num único componente? Quem do seu time perceberia se eles voltassem?
9. Se você já pratica
- Ligue a página de documentação de cada componente ao padrão do APG, e copie a tabela de teclado para a documentação.
- Rode verificações automáticas no Storybook em todas as histórias, e mantenha um roteiro curto de teste manual por componente para o que as ferramentas não pegam.
- Inclua pessoas que usam tecnologia assistiva nos testes dos componentes mais difíceis: combobox, diálogo, seletor de data.
- Trate um bug de acessibilidade num componente como impeditivo de release, porque ele vai para todos os lugares.
Checklist
Para saber mais
- W3C: ARIA Authoring Practices Guide, padrões · Read Me First · Using ARIA · Labeling controls
- Padrões do APG usados aqui: Button · Dialog (Modal) · Combobox · Disclosure
- GOV.UK Design System, Text input · Heydon Pickering, Inclusive Components: Cards
Livros, cursos e vídeos para ir mais fundo
- Inclusive ComponentsHeydon PickeringLivro · Smashing Magazine, 2019 (Amazon)
- Digital Accessibility FoundationsW3C WAICurso · gratuito, curso online, em inglês (site externo)
Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.
Relacionadas
Composição em vez de configuração · De componentes a padrões · Fundamentos de acessibilidade · Estados e casos-limite · Formulários · Estados interativos: hover, pressionado, foco · Storybook e documentação viva · Checklist de acessibilidade do componente