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.
<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.
<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.
<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.
.disabledalone 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.
| Token | Default | Purpose | Scope / state |
|---|---|---|---|
--pagination-gap | var(--spacer-1) | Space between child elements. | .pagination |
--pagination-item-min-width | 2.25rem | Minimum width of a page link. | .pagination |
--pagination-item-padding-y | var(--spacer-1) | Page link top and bottom padding. | .pagination |
--pagination-item-padding-x | var(--spacer-2) | Page link left and right padding. | .pagination |
--pagination-item-border-radius | 9999px | Page link corner radius. | .pagination |
--pagination-item-color | var(--text-color) | Page link text color. | .pagination |
--pagination-item-bg-color | transparent | Page link background. | .pagination |
--pagination-item-hover-color | var(--action-color) | Page link text color on hover. | .pagination |
--pagination-item-hover-bg-color | var(--bg-highlight) | Page link background on hover. | .pagination |
--pagination-item-active-color | var(--on-primary) | Current page link text color. | .pagination |
--pagination-item-active-bg-color | var(--primary) | Current page link background. | .pagination |
--pagination-item-disabled-color | var(--disabled-text-color) | Disabled page link text color. | .pagination (disabled) |
--pagination-item-focus-outline-width | var(--focus-outline-width) | Focus ring thickness. | .pagination (focus) |
--pagination-item-focus-outline-style | var(--focus-outline-style) | Focus ring line style. | .pagination (focus) |
--pagination-item-focus-outline-color | var(--focus-outline-color) | Focus ring color. | .pagination (focus) |
--pagination-item-focus-outline-offset | var(--focus-offset) | Distance between the focus ring and control. | .pagination (focus) |
--pagination-transition-duration | var(--transition-duration) | Duration of visual state transitions. | .pagination |
--pagination-transition-easing | var(--transition-easing) | Timing curve for visual state transitions. | .pagination |