Breadcrumb
| Versões do DS | V3 e V4 |
| Papel (role) | navigation (com lista de links) |
| Elemento HTML | <nav aria-label="…"><ol><li><a> |
| Classe / componente | br-breadcrumb |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds · next-ds.
Nome acessível
A região leva nome acessível (por exemplo, "Breadcrumb" ou "Você está aqui"); cada item, o texto do link; a página atual não é link. Exemplo: Breadcrumb.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, navegação · {nome}, link{estado}
Estados
Página atual
- No código:
aria-current="page" - Acrescenta ao anúncio: página atual
Itens intermediários recolhidos
- No código:
botão com aria-expanded e nome "Mostrar caminho completo" - Acrescenta ao anúncio: recolhido
Teclado
| Tecla | O que faz |
|---|---|
| Tab | Navega para o próximo item interativo |
| Shift+Tab | Navega para o item interativo anterior |
| Enter | Ativa links e controles expansíveis |
| Espaço | Ativa botões expansíveis, quando houver |
Para o desenvolvimento
br-breadcrumb (V3) / <br-breadcrumbs> (V4, id "breadcrumbs" na base). Separadores visuais decorativos (aria-hidden). Página atual com aria-current="page". No exemplo V3: aria-label="Breadcrumbs" e role="list".
Diferenças entre V3 e V4
- V4: notaCodigo: Use <nav aria-label="Breadcrumb"> com <ol>/<li>; a base V4 chama o componente "breadcrumbs".
Fontes
- DS gov.br V4 · next-ds — Breadcrumb, acessibilidade
- DS gov.br V3 · @govbr-ds/core — Breadcrumb (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Breadcrumb Pattern
- eMAG 3.1 · eMAG 3.1 — Recomendação 3.4 (informar o usuário sobre sua localização na página)
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.