Pagination
Com reticência
Lista curta
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
| Prop | Tipo | Padrão |
|---|---|---|
onPageChangeobrigatória0.4.0Chamado com a pagina nova, contando de 1, pelas setas e pelos numeros. | (page: number) => void | sem padrão |
pageobrigatória0.4.0A pagina atual, contando de 1. | number | sem padrão |
pageCountobrigatória0.4.0Quantas paginas existem. | number | sem padrão |
labelsOs 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.0Quantos numeros aparecem em volta da pagina atual. | number | 1 |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.