Pagination
| Versões do DS | V3 |
| Papel (role) | navigation (lista de links de página) |
| Elemento HTML | <nav aria-label="Paginação"><ul><li><a aria-current="page"> |
| Classe / componente | br-pagination |
| Origem | Veio da documentação do DS gov.br, completada onde faltava. |
Documentação oficial: gov.br/ds.
Nome acessível
A região "Paginação"; cada página "Página N" (aria-label); anterior/próxima com nome claro. Exemplo: Página 4.
O que é anunciado
Esperado conforme o padrão (WAI-ARIA APG): {nome}, link{estado}
Estados
Página atual
- No código:
aria-current="page" - Acrescenta ao anúncio: página atual
Desabilitado
- No código:
aria-disabled="true" - Acrescenta ao anúncio: indisponível
Teclado
| Tecla | O que faz |
|---|---|
| Tab / Shift+Tab | Move entre anterior, páginas e próxima |
| Enter | Vai para a página do link em foco |
Para o desenvolvimento
br-pagination (V3). O core usa aria-label="paginação" na região, aria-label "Página N" nos links e "Voltar página"/"Próxima página" nos extremos. O seletor de itens por página usa role="menu"/"menuitem" no exemplo. Depois de trocar de página, anuncie o resultado (região viva) e leve o foco ao início da lista.
Fontes
- DS gov.br V3 · @govbr-ds/core — Pagination (documentação e código de exemplo)
- W3C WAI-ARIA APG · WAI-ARIA APG — Landmark Regions
- WCAG · WCAG 2.2 — 4.1.3 Mensagens de status
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.