Pular para o conteúdo
Navegação

Pagination

/componentes/pagination.mdmarkdown cru, para quem lê com agent em vez de olho

Com reticência

Lista curta

Importar
import { Pagination } from '@rivocode/ui'

Quando usar

Navegação entre páginas de uma listagem.

A lista de números encolhe sozinha, então ela ocupa a mesma largura com dez ou com dez mil páginas. No celular os números somem e ficam só as setas com "3 de 12": alvo de 32px erra o vizinho, e quase sempre se quer a próxima.

O estreito é o de quem contém a paginação, e não o da janela: abaixo de 384px (24rem) do elemento pai, que é onde sete números e as duas setas deixam de caber, os números somem, no telefone e também na coluna estreita de uma tela larga. A peça mede o pai, e não a si mesma, porque dentro de uma linha flex ela tem a largura do próprio conteúdo. Antes da primeira medida, vale a janela.

onPageChange recebe a página nova, contando de 1; quem troca o page é quem chamou. Os textos moram em labels: navigation é o nome da região, previous e next os das setas, page o de cada número e position o "3 de 12" da tela estreita. No DataTable com pageSize, eles chegam por labels.pagination.

Nas bordas a peça não mente: pageCount abaixo de 1 conta como uma página, o page fora da faixa aparece preso a ela (9 de 5 sai "5 de 5", com o 5 marcado e a seta de voltar indo para o 4), e com uma página só as duas setas ficam travadas.

O foco não se perde na ponta

Chegar à última página pela seta trava a seta, e um botão travado não guarda foco: o navegador o mandaria para o começo do documento, e quem anda pelo teclado recomeçaria a página inteira. A peça leva o foco para o número da página atual, que é o próximo passo útil; na tela estreita, onde os números não aparecem, para a seta do outro lado. O mesmo vale na primeira página. Foco que estava fora da paginação não é tocado.

Quando não usar

Numa listagem do DataTable, não monte a paginação à mão: com pageSize, a tabela já traz esta peça e passa os textos por labels.pagination.

Feed, log ou histórico que se lê rolando é VirtualList, que desenha só o que cabe: número de página no meio de uma leitura contínua obriga a pessoa a lembrar onde parou. E as etapas de um fluxo são Steps, e não páginas.

No React Native

Não porta, por decisão - lista de celular rola; escolher o número da página é gesto de mesa. Não é fila: não vai existir. A tabela de paridade diz o porquê de cada uma.

API

PropTipoPadrão
onPageChangeobrigatória0.4.0

Chamado com a pagina nova, contando de 1, pelas setas e pelos numeros.

(page: number) => voidsem padrão
pageobrigatória0.4.0

A pagina atual, contando de 1.

numbersem padrão
pageCountobrigatória0.4.0

Quantas paginas existem.

numbersem padrão
labels

Os textos da peca, para trocar o idioma: `navigation` e o nome da regiao, `previous` e `next` os das setas, `page` o de cada numero e `position` a contagem que aparece no lugar dos numeros em tela estreita.

Partial<PaginationLabels>sem padrão
siblings0.4.0

Quantos numeros aparecem em volta da pagina atual.

number1

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.