Examples
Pagination
Page buttons for a long list, a table or search results: Previous, the pages around the current one with ellipses, and Next. The compact variant fits a phone. For an endless feed, load more as the user scrolls instead.
import { Pagination } from 'patine-ui';
Loading…
<Box gap="md" style={{ maxWidth: 480 }}> <List title="Orders"> {shown.map((o) => ( <ListItem key={o.id} title={`Order #${o.id}`} value={`$${o.total}.00`} /> ))} </List> <Pagination pageCount={Math.ceil(ORDERS.length / PER_PAGE)} page={page} onPageChange={setPage} iconOnly /> <Text size="sm" color="textSecondary">Showing {(page - 1) * PER_PAGE + 1}–{Math.min(page * PER_PAGE, ORDERS.length)} of {ORDERS.length}</Text> </Box>
Try the props
variantsiblingCountlabelsdesign<Pagination
pageCount={20}
page={page}
onPageChange={setPage}
/>
Example: search results
A help center's search: ten results a page, the page goes back to 1 when the query changes, and the compact variant keeps the controls short on a phone.
Loading…
<Box gap="md" style={{ width: '100%', maxWidth: 480 }}> <SearchField value={query} onChangeText={(text) => { setQuery(text); setPage(1); }} placeholder="Search help articles" /> <Text size="sm" color="textSecondary">{hits.length} articles</Text> <List> {hits.slice((page - 1) * PER_PAGE, page * PER_PAGE).map((a) => ( <ListItem key={a.id} title={a.title} description={a.topic} onPress={() => {}} /> ))} </List> {hits.length > PER_PAGE ? <Pagination variant="compact" pageCount={pageCount} page={page} onPageChange={setPage} /> : null} </Box>
Which pages show
Both ends, the current page with siblingCount pages on each side, and an ellipsis for each gap, so the number of buttons stays the same as the page moves and they don't jump under the pointer. boundaryCount sets how many pages stay at each end.
Compact
variant="compact" shows Previous, "Page 3 of 10" and Next, for a narrow screen. labels.status rewords it.
Loading…
<Pagination pageCount={24} defaultPage={3} variant="compact" />
Designs
- brand: the current page filled with the primary color.
- iOS: the current page on a gray fill.
- Material 3: round page buttons, the current one filled.
- web: the current page outlined, the others ghost, as shadcn's Pagination.
Accessibility
- A
navigationlandmark named'Pagination'. Each page is a button named'Page 4'; the current one is selected andaria-current="page". Ellipses are hidden. - Previous and Next are disabled at the ends. The compact text is announced as it changes.
- Buttons are 44pt on phones; on the web, Tab and the arrow keys move between them.
- Every word is in
labels, for translation.
Props
Also takes View props.
| Prop | Type | Default | Description |
|---|---|---|---|
pageCount | number | — | How many pages there are. |
page | number | — | The current page, from 1, controlled. |
defaultPage | number | 1 | The first page when uncontrolled. |
onPageChange | (page: number) => void | — | Called with the page the user goes to. |
siblingCount | number | 1 | Pages each side of the current one. |
boundaryCount | number | 1 | Pages always shown at each end. |
variant | 'numbers' | 'compact' | 'numbers' | Page buttons, or "Page 3 of 10". |
iconOnly | boolean | false | Previous and Next as arrows only. |
disabled | boolean | false | Disables every button. |
labels | { nav, previous, next, page(n), status(n, count) } | English | Every word, for translation. |
theme, design | As every component. |