Pagination

Pagination affords navigation between pages of content and highlights which page is currently in view.

Anatomy

Anatomy of the pagination component.
  1. Previous icon button is a tertiary icon only button that lets users navigate to the previous group of items.
  2. Next icon button is a tertiary icon only button that lets users navigate to the next group of items.
  3. Active item represents the active page or group of items currently being displayed at the moment.
  4. Ellipsis indicates more pages in between the first three and the last one.
  5. Last item represents the last page or group of items.

Usage

When to Use

Use pagination when you have more than twelve items to display, and you want to arrange them in groups for a better distribution and easy navigation.

When Not to Use

Don’t use pagination when you have fewer than twelve items to display. Use a carousel or show them right away instead.

Variants

There is only one type of pagination, no variations.

The only one available component for pagination
Variation
Purpose
Underline on Item
Sizes

Pagination

Use to arrange a series of elements into groups and display them one by one on separate group views.

With underline (active), no underline (default)

Single size

Number With Underline

Add an underline below the view number when the group is being displayed.

Showing component having a number with an underline

Number With No Underline

Don’t add an underline below the view number when the group is not being displayed.

How it looks like for the component to not have an underline.

Container

Spacing

Ensure that proper space is given between each pagination item. The distance between each item is 16px, and items are horizontally center-aligned.

Shows the spacing between elements within the pagination component.

Also, when grouping with another set of components, ensure that proper space is given between the pagination component and the displayed component group. The distance between them is 24px, and items are center-aligned.

Shows the component spacing from other groups of content.

Alignment

Pagination items are center aligned within their container. The pagination component should be center aligned with content at the same level of the page should follow a center-aligned pattern.

Pagination component alignment
Shows the pagination compoentn centered from the group

Do center the pagination component with the displayed group of items.

Don'ts for pagination component alignment

Don’t left-or right align the pagination component with the group of items.

Placement of pagination component

Do place the pagination component below of the displayed group of items.

Showing the wrong placement for the pagination component

Don’t place the pagination component above or at the side of the group of items being displayed.

Themes

Pagination on dark theme
Dark
Pagination on mid theme
Mid
Pagination on light theme
Light