Pular para o conteúdo principal

Loading

Versões do DSV3 e V4
Papel (role)progressbar (V3) · status (V4, anúncio único)
Elemento HTML<div role="progressbar"> ou <div role="status">
Classe / componentebr-loading
OrigemVeio da documentação do DS gov.br, completada onde faltava.

Documentação oficial: gov.br/ds · next-ds.

Nome acessível​

Sempre tem nome acessível, mesmo sem rótulo visível: diga o que carrega e onde. Exemplo: Carregando seus pedidos.

O que é anunciado​

Esperado conforme o padrão (WAI-ARIA APG): {nome}, indicador de progresso{estado}

Comportamento esperado, não a fala exata: NVDA, JAWS, VoiceOver e TalkBack variam. No plugin, cada elemento tem um campo para o resultado do teste com leitor de tela real.

Estados​

Indeterminado​

  • No código: sem aria-valuenow
  • Acrescenta ao anúncio: carregando

Determinado (com porcentagem)​

  • No código: aria-valuemin="0" aria-valuemax="100" aria-valuenow="{n}"
  • Acrescenta ao anúncio: {n} por cento

Concluído​

  • No código: remover o indicador e anunciar o resultado em região viva
  • Acrescenta ao anúncio: (resultado do carregamento)

Teclado​

TeclaO que faz
TabMantém a navegação entre elementos interativos do contexto; o Loading não entra no foco
Shift+TabRetorna ao elemento interativo anterior do fluxo, sem focar o indicador
Fonte: documentação do DS gov.br (V4).

Para o desenvolvimento​

br-loading (V3) / <br-loading> (V4). Não deve virar parada de foco. Anuncie o estado de espera uma vez, sem repetir a cada ciclo da animação, e anuncie o resultado ao concluir (aria-live="polite"). O exemplo do core usa role="progressbar" com aria-label e aria-valuenow.

Diferenças entre V3 e V4​

  • V3: papel: progressbar · notaCodigo: br-loading com role="progressbar", aria-label e, quando determinado, aria-valuemin/aria-valuenow/aria-valuemax (exemplo do core).
  • V4: papel: status · notaCodigo: <br-loading>: o estado de espera é anunciado uma vez, de forma discreta; nome acessível obrigatório mesmo sem rótulo visível.

Fontes​

Comentários e evolução

Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.