Pagination

Items shown per page. The items-per-page selector offers `pageSizeOptions` filtered to those ≤ `itemsTotal`. Supports two-way binding.

Total item count across all pages. Drives the "X – Y / Z" summary and, when `pageCount` is omitted, the derived page count + items-per-page capping.

Current page index. 0-based by default — set `zeroBased={false}` for 1-based indexing. Supports two-way binding. Omitted, it is the first page: `0`, or `1` when `zeroBased` is `false`.

Explicit total page count. Wins over the value derived from `itemsTotal` / `itemsPerPage` — a host with server-side pagination (only one page of rows in memory) passes its known total here.

Emphasis for the navigation buttons.

Layout scale; also mirrored onto the child Button/Select `size`.

Fires with the new page size when the items-per-page select changes.

Fires with the new page (and the previous one) whenever navigation or the page select commits a change.

Fires after the first-page button commits its page change.

Fires after the last-page button commits its page change.

Fires after the next button commits its page change.

Fires after the previous button commits its page change.

Options offered by the items-per-page select.

Whether `page` uses 0-based indexing (page 0 = first page). When `false`, uses 1-based indexing (page 1 = first page).

Localize every string the pagination renders. The control keys (`first`, `previous`, `next`, `last`, `page`, `itemsPerPage`) accept `text` to change the copy and `visuallyHidden` to toggle screen-reader-only vs visible (navigation buttons default to `visuallyHidden: true` — icon-only, with the text as `aria-label`). The dynamic readouts `summary` ("1 - 10 / 95") and `pageOf` ("/ 10") accept a function of their values or a `{placeholder}` template string, so any word order works. Omitted keys keep the English defaults. In Astro, prefer template strings: functions can't cross the SSR → client boundary, so the hydrated controls would fall back to the defaults after the first interaction.

Stable id used to associate `<label>`s with their `<select>`s.

Per-slot escape hatch. Container slots accept `style` (merged into the slot class) and `props`; control slots forward `props` onto the child Button/Select. See the PassThrough docs.