Components/Navigation
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/pagination
Pagination splits up large amounts of content into multiple pages.
<Tabs/> instead.<Stepper/> instead.Control the total number of pages available with the totalPages prop.
This number starts from two and has no maximum value.
Specify which page is currently selected with the currentPage prop.
The first page will be selected, if not specified otherwise.
| Name | Type | Default | Description |
|---|---|---|---|
currentPage | number | 1 | Specifies a currently selected page. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | |
nextLabel | string | — | Sets next page label. |
onBlur | (event: FocusEvent, triggers: Triggers) => void | — | |
onChange | (event: { event: SyntheticEvent<Element, Event>; page: number; }) => void | — | Defines a callback function which returns a selected page or an arrow ({event,page}) |
onFocus | (event: FocusEvent, triggers: Triggers) => void | — | |
pageUrl | (pageNumber: number) => string | — | Get pageNumber and returns url. |
previousLabel | string | — | Sets previous page label. |
ref | RefObject | — | |
totalPages | number | — | Sets a number of available pages to show in the component. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isVisible | Check if element is rendered |
getCurrentPage | Returns currently selected page |
getTotalPages | Returns a total amount of pages available |
clickOnPage | Clicks on gives page number |
clickNextButton | Clicks on next button |
clickPreviousButton | Clicks on previous button |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
Last updated: 21 October 2026