Pagination

Navigation across pages of related content.

When to use

Use pagination when a collection is split into addressable pages. Keep page links connected to the active query and filters; show enough context to identify the current page.

Default

Combine .pagination with .pagination-item.

HTML
<nav class="pagination" aria-label="Pagination">
	<a class="pagination-item" href="#">Previous</a>
	<a class="pagination-item" href="#">1</a>
	<a class="pagination-item is-active" href="#" aria-current="page">2</a>
	<a class="pagination-item" href="#">3</a>
	<a class="pagination-item" href="#">Next</a>
</nav>

Disabled item

Use .disabled for unavailable items.

HTML
<nav class="pagination" aria-label="Pagination">
	<span class="pagination-item disabled">Previous</span>
	<a class="pagination-item is-active" href="#" aria-current="page">1</a>
	<a class="pagination-item" href="#">2</a>
	<a class="pagination-item" href="#">3</a>
	<a class="pagination-item" href="#">Next</a>
</nav>

With ellipsis

Use .pagination-ellipsis for skipped ranges.

HTML
<nav class="pagination" aria-label="Pagination">
	<a class="pagination-item" href="#">Previous</a>
	<a class="pagination-item" href="#">1</a>
	<span class="pagination-item pagination-ellipsis">…</span>
	<a class="pagination-item" href="#">8</a>
	<a class="pagination-item is-active" href="#" aria-current="page">9</a>
	<a class="pagination-item" href="#">10</a>
	<span class="pagination-item pagination-ellipsis">…</span>
	<a class="pagination-item" href="#">20</a>
	<a class="pagination-item" href="#">Next</a>
</nav>

Accessibility and behavior

  • Use a labelled navigation landmark and real links for page destinations. Mark the current page with aria-current="page" as well as its visible number.
  • Render unavailable destinations as non-interactive text, as in the Previous example. .disabled alone does not disable a link.
  • Ellipses are static text, not actions. Preserve the current search and filters when generating links, and maintain visible focus on every available destination.

CSS variables

Override these base defaults on the listed selector after the library styles. Variants and states may replace them; global tokens follow the active theme.

TokenDefaultPurposeScope / state
--pagination-gapvar(--spacer-1)Space between child elements..pagination
--pagination-item-min-width2.25remMinimum width of a page link..pagination
--pagination-item-padding-yvar(--spacer-1)Page link top and bottom padding..pagination
--pagination-item-padding-xvar(--spacer-2)Page link left and right padding..pagination
--pagination-item-border-radius9999pxPage link corner radius..pagination
--pagination-item-colorvar(--text-color)Page link text color..pagination
--pagination-item-bg-colortransparentPage link background..pagination
--pagination-item-hover-colorvar(--action-color)Page link text color on hover..pagination
--pagination-item-hover-bg-colorvar(--bg-highlight)Page link background on hover..pagination
--pagination-item-active-colorvar(--on-primary)Current page link text color..pagination
--pagination-item-active-bg-colorvar(--primary)Current page link background..pagination
--pagination-item-disabled-colorvar(--disabled-text-color)Disabled page link text color..pagination (disabled)
--pagination-item-focus-outline-widthvar(--focus-outline-width)Focus ring thickness..pagination (focus)
--pagination-item-focus-outline-stylevar(--focus-outline-style)Focus ring line style..pagination (focus)
--pagination-item-focus-outline-colorvar(--focus-outline-color)Focus ring color..pagination (focus)
--pagination-item-focus-outline-offsetvar(--focus-offset)Distance between the focus ring and control..pagination (focus)
--pagination-transition-durationvar(--transition-duration)Duration of visual state transitions..pagination
--pagination-transition-easingvar(--transition-easing)Timing curve for visual state transitions..pagination