--- layout: documentation doc-tab: components doc-subtab: pagination variables: - name: $pagination-color value: $grey-darker - name: $pagination-border-color value: $grey-lighter - name: $pagination-margin value: -0.25rem - name: $pagination-hover-color value: $link-hover - name: $pagination-hover-border-color value: $link-hover-border - name: $pagination-focus-color value: $link-focus - name: $pagination-focus-border-color value: $link-focus-border - name: $pagination-active-color value: $link-active - name: $pagination-active-border-color value: $link-active-border - name: $pagination-disabled-color value: $grey - name: $pagination-disabled-background-color value: $grey-lighter - name: $pagination-disabled-border-color value: $grey-lighter - name: $pagination-current-color value: $link-invert - name: $pagination-current-background-color value: $link - name: $pagination-current-border-color value: $link - name: $pagination-ellipsis-color value: $grey-light --- {% capture pagination_example %} {% endcapture %} {% capture pagination_options_example %} {% endcapture %} {% capture pagination_centered_example %} {% endcapture %} {% capture pagination_right_example %} {% endcapture %} {% capture pagination_small_example %} {% endcapture %} {% capture pagination_medium_example %} {% endcapture %} {% capture pagination_large_example %} {% endcapture %} {% include subnav-components.html %}

Pagination

A responsive, usable, and flexible pagination

{% include meta.html colors=false sizes=true variables=true %}

The pagination component consists of several elements:

  • pagination-previous and pagination-next for incremental navigation
  • pagination-list which displays page items:
    • pagination-link for the page numbers
    • pagination-ellipsis for range separators

All elements are optional so you can compose your pagination as you wish.

{% include snippet.html content=pagination_example horizontal=true more=true %}

You can disable some links if they are not active, or change the amount of page numbers available.

{% include snippet.html content=pagination_options_example horizontal=true more=true %}

By default on tablet, the list is located on the left, and the previous/next buttons on the right. But you can change the order of these elements by using the is-centered and is-right modifiers.

{% include snippet.html content=pagination_centered_example horizontal=true more=true %} {% include snippet.html content=pagination_right_example horizontal=true more=true %} {% include anchor.html name="Sizes" %}

The pagination comes in 3 additional sizes.
You only need to append the modifier is-small, is-medium, or is-large to the pagination component.

{% include snippet.html content=pagination_small_example horizontal=true more=true %} {% include snippet.html content=pagination_medium_example horizontal=true more=true %} {% include snippet.html content=pagination_large_example horizontal=true more=true %} {% include variables.html %}