Marcus Andrey Estudo
Read in English Biblioteca

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 HarbourPadrão do APGTecladoPapéis, estados, propriedades
ButtonButtonEnter e Espaço acionamUm <button> de verdade; aria-disabled="true" enquanto carrega; aria-pressed só em botões de alternância
Text fieldNenhum: o HTML nativo é o padrãoTab para entrar, digitar, Tab para sair<label for>; dica e erro ligados com aria-describedby; aria-invalid="true" no erro; autocomplete
Ticket cardNenhum: um card é um grupo, não um widgetO Tab passa só pelas ações deleA rota é um título; nenhum papel no card; um controle por ação
Seletor de portoCombobox↓ abre a lista e entra nela, Esc fecharole="combobox", aria-expanded, aria-controls, aria-activedescendant
Diálogo de cancelar reservaDialog (Modal)O Tab fica dentro; Esc fecha; o foco volta para o botão que abriurole="dialog", aria-modal="true", aria-labelledby apontando para o título
Detalhes do bilheteDisclosureEnter e Espaço mostram e escondemUm botão com aria-expanded true ou false
O contrato de acessibilidade do Harbour, uma linha por componente. Quando o WAI-ARIA Authoring Practices Guide tem um padrão, o componente segue e aponta para ele; quando não tem, a resposta é HTML simples. Esta tabela deve estar na página de documentação de cada componente.Patterns: W3C, ARIA Authoring Practices Guide.

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-disabled com 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-activedescendant aponta 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-expanded true 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.

Como aparece no seu passaporte ou documento de identidade Digite o sobrenome do passageiro 2
Só usamos se a sua travessia mudar
O Text field do Harbour, de verdade e focável, no estado de erro. O rótulo é um <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).
  • autocomplete com 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 div com 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)

  1. Abra um formulário num produto que você usa. Deixe o mouse de lado.
  2. Chegue com Tab a um campo com erro. O erro está ao lado dele, em palavras? Diz como corrigir?
  3. 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

Livros, cursos e vídeos para ir mais fundo

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

Salvo só neste dispositivo.

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