Pagination

pageCount

number

Default: —

Total pages. Or pass total + pageSize.

total / pageSize

number

Default: — / 10

Item count → derives pageCount.

page / defaultPage

number

Default: — / 1

Controlled / initial page (1-based).

onChange

(page: number) => void

Default: —

Fired on any page change.

isDisabled

boolean

Default: false

Disable every button.

getItemAriaLabel

(type, page, isSelected) => string

Default: —

Localise the button labels.

siblingCount

number

Default: 1

Pages shown either side of the current one.

boundaryCount

number

Default: 1

Pages always shown at each end.

showEdges

boolean

Default: false

First / last jump buttons.

hideNavigation

boolean

Default: false

Hide the prev / next arrows.

size

"sm" | "md" | "lg"

Default: md

Control size.

classNames

{ base?, list?, item?, page?, prev?, next?, ellipsis? }

Default: —

Slot classes.

PaginationSummary

{ page, pageSize, total, format? }

Default: —

Renders "Showing X–Y of Z"; format(from, to, total) overrides the text.