Pagination

Easily create a nice looking pagination to navigate through pages.

Table of contents

Usage

The Pagination component consists of button-like styled links, that are aligned side by side in a horizontal list.

ClassDescription
.z-paginationAdd this class to a <ul> element to define the Pagination component. Use <a> elements as pagination items within the list.
.z-activeAdd this class to a list item to apply an active state and use a <span> instead of an <a> element.
.z-disabledAdd this class to a list item to apply a disabled state and use a <span> instead of an <a> element.

To add an icon, just add the data-z-pagination-previous or data-z-pagination-next attribute to a <span> element inside a pagination item.

Style modifiers

There are several style modifiers available. Just add one of the following classes to apply a different look.

  • .z-pagination-default
  • .z-pagination-ghost
  • .z-pagination-primary
  • .z-pagination-secondary
  • .z-pagination-success
  • .z-pagination-warning
  • .z-pagination-info
  • .z-pagination-danger

Size modifiers

There are several size modifiers available. Just add one of the following classes to make the pagination smaller or larger.

ClassDescription
.z-pagination-xsmallApplies extra small size.
.z-pagination-smallApplies small size.
.z-pagination-mediumApplies medium size.
.z-pagination-largeApplies large size.

Alignment

The Pagination component utilizes flexbox, so navigations can easily be aligned with Flex utility classes.

<ul class="z-pagination justify-center">
  ...
</ul>

Accessibility

The previous/next pagination adheres to the button pattern and automatically sets the appropriate WAI-ARIA roles, states and properties.

  • The prev/next pagination items have the button role and the aria-label property.

Internationalization

The Pagination component uses the following translation strings. Learn more about translating components.

KeyDefaultDescription
labelNext/Previous pagearia-label attribute.