Components
Pagination
Page links for long lists and results — active page in gold, no script.
How it works
Pagination is plain HTML: a <ul class="pagination"> of .page-item entries
wrapped in a <nav>. Nothing is scripted. The theme sets the active page to
gold with navy text, uses the 2px radius on each link and the gold focus ring.
- Baseline: links. Works everywhere.
- Enhancement: none needed.
- Fallback: none needed.
Overview
Wrap the list in a <nav> with an aria-label that describes what is paged.
Large blocks of links are easier to scan when the block has a clear role.
HTML
<nav aria-label="Results pages">
<ul class="pagination">
<li class="page-item"><a class="page-link" href="#!">Previous</a></li>
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item"><a class="page-link" href="#!">2</a></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
<li class="page-item"><a class="page-link" href="#!">Next</a></li>
</ul>
</nav>Working with icons
Use an icon or symbol instead of text. Keep an aria-label on the link so the meaning survives
for assistive technology.
HTML
<nav aria-label="Results pages">
<ul class="pagination">
<li class="page-item">
<a class="page-link" href="#!" aria-label="Previous">
<span aria-hidden="true">«</span>
</a>
</li>
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item"><a class="page-link" href="#!">2</a></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
<li class="page-item">
<a class="page-link" href="#!" aria-label="Next">
<span aria-hidden="true">»</span>
</a>
</li>
</ul>
</nav>Disabled and active states
.disabled on a .page-item greys the link and sets pointer-events: none.
Add tabindex="-1" and aria-disabled="true" so keyboard users skip it, or use a
<span> instead of a link. .active marks the current page in gold; add
aria-current="page".
HTML
<nav aria-label="Results pages">
<ul class="pagination">
<li class="page-item disabled">
<a class="page-link" aria-disabled="true" tabindex="-1">Previous</a>
</li>
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item active" aria-current="page">
<a class="page-link" href="#!">2</a>
</li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
<li class="page-item">
<a class="page-link" href="#!">Next</a>
</li>
</ul>
</nav>You can also swap active or disabled anchors for <span>, which removes the click entirely.
HTML
<nav aria-label="Results pages">
<ul class="pagination">
<li class="page-item disabled">
<span class="page-link">Previous</span>
</li>
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item active" aria-current="page">
<span class="page-link">2</span>
</li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
<li class="page-item">
<a class="page-link" href="#!">Next</a>
</li>
</ul>
</nav>Sizing
.pagination-lg and .pagination-sm change padding and font size.
HTML
<nav aria-label="Large pagination">
<ul class="pagination pagination-lg">
<li class="page-item active" aria-current="page">
<span class="page-link">1</span>
</li>
<li class="page-item"><a class="page-link" href="#!">2</a></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
</ul>
</nav>HTML
<nav aria-label="Small pagination">
<ul class="pagination pagination-sm">
<li class="page-item active" aria-current="page">
<span class="page-link">1</span>
</li>
<li class="page-item"><a class="page-link" href="#!">2</a></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
</ul>
</nav>Alignment
.pagination is a flex container, so flex utilities move it.
HTML
<nav aria-label="Centered pagination">
<ul class="pagination justify-content-center">
<li class="page-item disabled">
<a class="page-link" aria-disabled="true">Previous</a>
</li>
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item"><a class="page-link" href="#!">2</a></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
<li class="page-item">
<a class="page-link" href="#!">Next</a>
</li>
</ul>
</nav>HTML
<nav aria-label="Right-aligned pagination">
<ul class="pagination justify-content-end">
<li class="page-item disabled">
<a class="page-link" aria-disabled="true">Previous</a>
</li>
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item"><a class="page-link" href="#!">2</a></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
<li class="page-item">
<a class="page-link" href="#!">Next</a>
</li>
</ul>
</nav>CSS
Local variables on .pagination. The active colour is gold-700 in light mode and gold-500 in dark mode.
.pagination {
--bs-pagination-padding-x: 0.75rem;
--bs-pagination-padding-y: 0.375rem;
--bs-pagination-font-size: 1rem;
--bs-pagination-color: var(--bs-link-color);
--bs-pagination-bg: var(--bs-body-bg);
--bs-pagination-border-width: var(--bs-border-width);
--bs-pagination-border-color: var(--bs-border-color);
--bs-pagination-border-radius: 2px;
--bs-pagination-hover-color: var(--bs-link-hover-color);
--bs-pagination-hover-bg: var(--bs-tertiary-bg);
--bs-pagination-hover-border-color: var(--bs-border-color);
--bs-pagination-focus-color: var(--bs-link-hover-color);
--bs-pagination-focus-bg: var(--bs-secondary-bg);
--bs-pagination-focus-box-shadow: 0 0 0 0.25rem rgba(184, 148, 31, 0.4);
--bs-pagination-active-color: #0a1b3d;
--bs-pagination-active-bg: #b8941f;
--bs-pagination-active-border-color: #b8941f;
--bs-pagination-disabled-color: var(--bs-secondary-color);
--bs-pagination-disabled-bg: var(--bs-secondary-bg);
--bs-pagination-disabled-border-color: var(--bs-border-color);
}
[data-bs-theme="dark"] .pagination {
--bs-pagination-active-bg: var(--bs-gold-500);
--bs-pagination-active-border-color: var(--bs-gold-500);
}
Override on one instance with an inline style:
HTML
<nav aria-label="Navy pagination">
<ul class="pagination" style="--bs-pagination-active-bg: var(--bs-navy); --bs-pagination-active-border-color: var(--bs-navy); --bs-pagination-active-color: var(--bs-cream);">
<li class="page-item"><a class="page-link" href="#!">1</a></li>
<li class="page-item active" aria-current="page"><span class="page-link">2</span></li>
<li class="page-item"><a class="page-link" href="#!">3</a></li>
</ul>
</nav>