Skip to main content

Examples

Default

Disabled

Custom Label

Middle Page

Interactive

Props

PageSelector

A compact control for stepping through a small, known set of pages one at a time, showing the position as “current of total” between a back and forward arrow. Use when the total is small and the exact page number matters less than moving between them, such as flicking through generated variants or a short carousel. Reach for Pagination instead when consumers need to jump to a specific numbered page.
number
required
Current active page (1-indexed).
number
required
Total number of pages.
string
default:"Page selector"
Accessible label for the <nav> landmark.
boolean
default:"false"
Whether the control is disabled.
((currentPage: number, totalPages: number) => string)
Formats the indicator between the arrows.
boolean
default:"false"
Whether reaching either end wraps around to the other.
string
default:"Next page"
Accessible label for the next-page button.
((page: number) => void)
Callback fired when the active page changes. Receives the new 1-indexed page number.
string
default:"Previous page"
Accessible label for the previous-page button.

Exported types

Also exported from @fanvue/ui: PageSelectorProps.
Setup: Installation · Theming