Pagination
Basic Example #
We use a large block of connected links for our pagination, making links hard to miss and easily scalable — all while
providing large hit areas. Pagination is built with list HTML elements so screen readers can announce the number of
available links. Use a wrapping
<nav>
element to identify it as a navigation section to screen readers and other assistive technologies.
In addition, as pages likely have more than one such navigation section, it's advisable to provide a descriptive
aria-label
for the
<nav>
to reflect its purpose. For example, if the pagination component is used to navigate between a set of search results, an
appropriate label could be
aria-label="Search results pages"
.
<nav aria-label="Page navigation example">
<ul class="pagination mb-0">
<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>
Sizing #
Fancy larger or smaller pagination? Add
.pagination-lg
or
.pagination-sm
for additional sizes.
<nav aria-label="Page navigation example">
<ul class="pagination pagination-lg">
<li class="page-item">
<a class="page-link page-link-sa-prev" href="#" aria-label="Previous"></a>
</li>
<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>
<li class="page-item">
<a class="page-link page-link-sa-next" href="#" aria-label="Next"></a>
</li>
</ul>
</nav>
<nav aria-label="Page navigation example">
<ul class="pagination">
<li class="page-item">
<a class="page-link page-link-sa-prev" href="#" aria-label="Previous"></a>
</li>
<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>
<li class="page-item">
<a class="page-link page-link-sa-next" href="#" aria-label="Next"></a>
</li>
</ul>
</nav>
<nav aria-label="Page navigation example">
<ul class="pagination pagination-sm mb-0">
<li class="page-item">
<a class="page-link page-link-sa-prev" href="#" aria-label="Previous"></a>
</li>
<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>
<li class="page-item">
<a class="page-link page-link-sa-next" href="#" aria-label="Next"></a>
</li>
</ul>
</nav>
Working With Icons #
Looking to use an icon in place of text for some pagination links? Be sure to provide proper screen reader support with
aria
attributes.
<nav aria-label="Page navigation example">
<ul class="pagination pagination-sm mb-0">
<li class="page-item">
<a class="page-link page-link-sa-prev" href="#" aria-label="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 page-link-sa-next" href="#" aria-label="Next"></a>
</li>
</ul>
</nav>
Disabled And Active States #
Pagination links are customizable for different circumstances. Use
.disabled
for links that appear un-clickable and
.active
to indicate the current page.
While the
.disabled
class uses
pointer-events: none
to
try
to disable the link functionality of
<a>
s, that CSS property is not yet standardized and doesn't account for keyboard navigation. As such, you should always
add
tabindex="-1"
on disabled links and use custom JavaScript to fully disable their functionality.
<nav aria-label="Page navigation example">
<ul class="pagination pagination-sm mb-0">
<li class="page-item disabled">
<a class="page-link" tabindex="-1" aria-disabled="true">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>
Alignment #
Change the alignment of pagination components with flexbox utilities.
<nav aria-label="Page navigation example">
<ul class="pagination pagination-sm">
<li class="page-item disabled">
<a class="page-link" tabindex="-1" 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>
<nav aria-label="Page navigation example">
<ul class="pagination pagination-sm justify-content-center">
<li class="page-item disabled">
<a class="page-link" tabindex="-1" 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>
<nav aria-label="Page navigation example">
<ul class="pagination pagination-sm justify-content-end mb-0">
<li class="page-item disabled">
<a class="page-link" tabindex="-1" 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>