Pagination
Numeric pagination with prev/next, ellipsis, and aria-current on the active page.
npx @slipstream-ui/cli@latest add paginationInteractive
showBoundaries — « jumps to page 1, » to page 10page 3 / 10
Custom glyphs + first-only boundary (showFirst, icons)
Default rendering (no boundary buttons)
Summary with derived pages
Showing 26–50 of 312 students
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| page | number | 1 | Current page (1-based). Alias: currentPage. |
| pageCount | number | — | Total pages. Alias: totalPages, or derived from total/pageSize. |
| currentPage / totalPages | number | — | Migration-friendly aliases for page / pageCount. |
| pageSize + total | number | — | Derives pageCount and renders "Showing 26–50 of 312 students". |
| itemLabel | string | 'items' | Noun used in the summary. |
| showSummary | boolean | — | Force the summary on/off (default: on when total and pageSize are set). |
| onPageChange | (page: number) => void | — | Called with the new page number. |
| siblings | number | 1 | How many page buttons to show around the current page. |
| showBoundaries | boolean | false | Adds « and » buttons that jump to the first/last page. |
| showFirst / showLast | boolean | showBoundaries | Show or hide each boundary button independently (e.g. hide « once you are on page 1 instead of disabling it). |
| icons | { first?, previous?, next?, last? } | — | Replace the default ‹ › « » glyphs with your own markup. |
Accessibility
- nav[aria-label=Pagination] landmark.
- Active button has aria-current=page; disabled buttons at boundaries.
- Boundary buttons expose First page / Last page labels.
Browser support
| Browser | Tested versions |
|---|---|
| Chrome | 111+ (Mar 2023) |
| Edge | 111+ (Mar 2023) |
| Firefox | 121+ (Dec 2023) |
| Safari | 17.2+ — macOS & iOS (Dec 2023) |
Slipstream components rely only on CSS custom properties, Flexbox/Grid, and ARIA — the everyday baseline of the last two years of evergreen releases. Anything newer is progressive enhancement: unsupported browsers keep full functionality with static behavior instead of animations.