Pular para o conteúdo principal

Pagination

Versões do DSV3
Papel (role)navigation (lista de links de página)
Elemento HTML<nav aria-label="Paginação"><ul><li><a aria-current="page">
Classe / componentebr-pagination
OrigemVeio 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}

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​

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​

TeclaO que faz
Tab / Shift+TabMove entre anterior, páginas e próxima
EnterVai para a página do link em foco
Fonte: curadoria (WAI-ARIA APG).

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​

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.