Loading
| Versões do DS | V3 e V4 |
| Papel (role) | progressbar (V3) · status (V4, anúncio único) |
| Elemento HTML | <div role="progressbar"> ou <div role="status"> |
| Classe / componente | br-loading |
| Origem | Veio 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}
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
| Tecla | O que faz |
|---|---|
| Tab | Mantém a navegação entre elementos interativos do contexto; o Loading não entra no foco |
| Shift+Tab | Retorna ao elemento interativo anterior do fluxo, sem focar o indicador |
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
- DS gov.br V4 · next-ds — Loading, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Loading (documentação e código de exemplo)
- WCAG · WCAG 2.2 — 4.1.3 Mensagens de status
- W3C WAI-ARIA APG · WAI-ARIA 1.2 — papel progressbar
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.