Pagination

Navigation and identification between multiple pages.

General

The basic Pagination usage.

Limit

The maximum number of pages that can be displayed

Icon

Customize buttons as icons.

Paginated list

Compute the page of items from page, and show the range next to the list.

APIs

Pagination.Props

AttributeDescriptionTypeAccepted valuesDefault
initialPagethe page selected by defaultnumber-1
pagecurrent pagenumber-1
countthe total number of pagesnumber-1
limitlimit of display pagenumber-7
onChangechange event(page: number) => void--
...native propsHTMLAttributes'id', 'className', ...-

Pagination.Previous.Props

AttributeDescriptionTypeAccepted valuesDefault
...native propsButtonHTMLAttributes'id', 'className', ...-

Pagination.Next.Props

AttributeDescriptionTypeAccepted valuesDefault
...native propsButtonHTMLAttributes'id', 'className', ...-

Ref

The ref points at the root nav element.

Accessibility

  • • The root is a nav named "Pagination", and the pages are buttons in a list.
  • • The current page has aria-current="page".
  • • Icon-only content in Pagination.Previous and Pagination.Next needs an aria-label.
Edit this page on GitHub