← Documentação · Componentes · Exemplos

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);
});
AtributoEfeito
totalTotal de itens; o número de páginas sai de total e por-pagina.
total-paginasNúmero de páginas, quando não há total de itens.
pagina, por-paginaPá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-paginaLista separada por vírgulas: mostra o seletor "Exibir".
informacaoMostra "1-10 de 100 itens" (precisa de total).
compactaVariante do rodapé de tabela: Exibir, informação, seletor "Página" e setas.
hrefModelo de URL, com {pagina}: os controles viram links reais (útil com renderização no servidor); o evento também é disparado.
janelaPáginas em volta da atual (padrão 5, mínimo 3); a primeira e a última sempre aparecem.
rotuloaria-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

Diferenças e limites em relação ao GOV.BR DS