# Pagination

Controlled pagination with item range and edge controls.

Use Pagination when a long result set is split into stable pages and readers need direct navigation.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `disabled` | `boolean` | prop | No | `false` | No additional description. |
| `firstPageLabel` | `string` | prop | No | `'First page'` | Accessible name for the first-page control. |
| `formatSummary` | `(from: number, to: number, total: number) => string` | callback | No | `(from, to, count) => `${from.toLocaleString()}–${to.toLocaleString()} of ${count.toLocaleString()}`` | Localise the summary; the kit ships an English default. |
| `label` | `string` | prop | No | `'Pagination'` | No additional description. |
| `lastPageLabel` | `string` | prop | No | `'Last page'` | Accessible name for the last-page control. |
| `nextPageLabel` | `string` | prop | No | `'Next page'` | Accessible name for the next-page control. |
| `onPageChange` | `(page: number) => void` | callback | No | `undefined` | No additional description. |
| `page` | `number` | binding | No | `1` | Current page, 1-based. Two-way bindable. |
| `pageSize` | `number` | prop | No | `50` | Items per page. |
| `previousPageLabel` | `string` | prop | No | `'Previous page'` | Accessible name for the previous-page control. |
| `showFirstLast` | `boolean` | prop | No | `true` | Render first/last jump controls. |
| `siblingCount` | `number` | prop | No | `1` | Page buttons kept on each side of the current one. |
| `size` | `ControlSize` | prop | No | `'md'` | No additional description. |
| `summary` | `boolean` | prop | No | `true` | Render the `1–50 of 1,234` line. |
| `total` | `number` | prop | Yes | - | Total item count. Drives the page count and the summary. |

## Related

- [Link](/docs/components/link): Styled native link for body and navigation text.
- [Segmented](/docs/components/segmented): Single-select segmented control.
- [Tabs](/docs/components/tabs): Panelled tabs with underline and pill presentations.