Pagination

In the Moon, it's not a good idea to swamp users with information because it makes it hard for them to find what they want. This is where pagination is used to split content or data into separate pages with arrows to navigate to/from each page.

Pagination helps to show users that there's more than one page to orbit around and read at their own time, allowing users to concentrate better on what's being presented. It's also great at helping to divide similar items or information into smaller groups/categories.

Use pagination when you have at least 25 items to show.

Default

Props

NameTypeRequiredDefaultDescription
pageCountnumberYes-The total number of pages.
pageRangeDisplayednumberYes-The range of pages displayed.
marginPagesDisplayednumberYes-The number of pages to display for margins.
previousButtonLabelstring, JSX.ElementNo-Label for "previous" button
nextButtonLabelstring, JSX.ElementNo-Label for "next" button
onChangefunctionNo-The method to call when a page is clicked. Exposes the current page object as an argument.
pageNumbernumberNo-To override selected page with parent prop.
pageSizeSectionJSX.ElementNo-Placeholder for "page size" component.
goToPageSectionJSX.ElementNo-Placeholder for "go to page" component
changePageSizeSectionJSX.ElementNo-Placeholder for "change page size" component