Status na matriz: Limitado. Referência: documentação do Bootstrap 5.3.
Paginação estática (.pagination)
Adaptação visual limitada da paginação Bootstrap. Mantém a estrutura e as classes
públicas do Bootstrap, sem JavaScript adicional nem classes .br-*.
Estados e navegação
Use Tab para conferir o foco visível; passe o ponteiro sobre os links para ver o estado hover.
Web component (<dsgovbr-paginacao>)
JS opcional (dsgovbr-bootstrapped-componentes.js) que monta a paginação com a lógica de janela
de páginas e reticências, em light DOM, só com as classes do Bootstrap
(.pagination, .page-item, .page-link, .form-select).
Lista numerada (padrão)
Com itens por página e informação
Compacta (rodapé de tabela)
Links reais (servidor)
<script src="dist/dsgovbr-bootstrapped-componentes.js" defer></script>
...
<dsgovbr-paginacao total="100" por-pagina="10" pagina="1"
opcoes-por-pagina="10,25,50" informacao></dsgovbr-paginacao>
document.addEventListener("dsgovbr:pagina", (e) => {
// e.detail: { pagina, porPagina, total, totalPaginas, origem } (origem: "pagina", "por-pagina" ou "api")
carregar(e.detail.pagina, e.detail.porPagina);
});
| Atributo | Efeito |
|---|---|
total | Total de itens; o número de páginas sai de total e por-pagina. |
total-paginas | Número de páginas, quando não há total de itens. |
pagina, por-pagina | Página atual (padrão 1) e itens por página (padrão: o primeiro de opcoes-por-pagina, ou 10). O componente mantém os dois em dia; também são propriedades (el.pagina = 3). |
opcoes-por-pagina | Lista separada por vírgulas: mostra o seletor "Exibir". |
informacao | Mostra "1-10 de 100 itens" (precisa de total). |
compacta | Variante do rodapé de tabela: Exibir, informação, seletor "Página" e setas. |
href | Modelo de URL, com {pagina}: os controles viram links reais (útil com renderização no servidor); o evento também é disparado. |
janela | Páginas em volta da atual (padrão 5, mínimo 3); a primeira e a última sempre aparecem. |
rotulo | aria-label do <nav> (padrão "Paginação de resultados"). |
A lógica da janela também está em dsgovbrPaginacao.janela(atual, totalPaginas, tamanho)
(ex.: janela(50, 100, 5) devolve [1, "…", 48, 49, 50, 51, 52, "…", 100]).
Uso acessível
- Envolva a lista em
<nav>com nome acessível. - Indique a página atual com
aria-current="page"; não dependa apenas da cor. - Para página indisponível, use
.disabledearia-disabled="true"; links continuam sendo navegação real e exigem URLs válidas.
Diferenças e limites em relação ao GOV.BR DS
- Estados ativo, desabilitado, foco e hover são estilizados no markup Bootstrap.
- A seção estática acima não implementa seletor de itens por página, dropdowns de reticências nem lógica de navegação; o web component traz a janela de páginas com reticências, o seletor "Exibir" e a variante compacta. O seletor de página é um
<select>nativo, não o dropdown do GOV.BR DS, e as reticências não abrem lista. - Os tamanhos
.pagination-sme.pagination-lgmantêm os paddings Bootstrap; apenas o mínimo dos links é preservado em 32px.