Navigation
Pagination
Navigation controls for moving between pages of content. Provides numbered links plus previous and next shortcuts.
Numbered Pagination
Import
import {
Pagination,
PaginationContent,
PaginationItem,
PaginationLink,
PaginationNext,
PaginationPrevious,
} from "@mikenotthepope/substrateui"Composition
Pagination
└── PaginationContent
└── PaginationItem
├── PaginationPrevious
├── PaginationLink
└── PaginationNextDirection
Previous and next buttons swap visually in RTL — the previous link sits on the right, next on the left, and the chevron icons rotate to point in reading direction. Order within the list follows the DOM, so logical ordering is preserved.
Labels
Three of the four strings are accessible names for controls that show only an icon or an ellipsis. Override one instance with the labels prop on the component, or every instance at once through LabelsProvider's pagination key — the provider is how you translate the set once instead of at each call site.
| Prop | Type | Default | Description |
|---|---|---|---|
pagination | string | "pagination" | aria-label on the nav element. |
previous / next | string | "Previous" / "Next" | The step buttons, whose visible content is a chevron. |
morePages | string | "More pages" | Accessible name for the ellipsis between page ranges. |
API Reference
| Prop | Type | Default | Description |
|---|---|---|---|
className | string | — | Additional CSS classes to apply to the pagination container. |