Pagination Examples
<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>
In addition,as pages likely have more than one such navigation section,it’s advisable to provide a descriptive aria-labelfor 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".
Disabled and active states
<nav aria-label="..."><ul class="pagination"><li class="page-item disabled"><a class="page-link"href="#"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 <span class="sr-only">(current)</span></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>
Pagination links are customizable for different circumstances. Use .disabledfor links that appear un-clickable and .activeto indicate the current page.
While the .disabledclass uses pointer-events:noneto tryto 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.
You can optionally swap out active or disabled anchors for <span>,or omit the anchor in the case of the prev/next arrows,to remove click functionality and prevent keyboard focus while retaining intended styles.
Pagination With Color
<nav aria-label="Page navigation example"><ul class="pagination"><li class="page-item"><a class="page-link border-primary bg-primary text-white"href="#">Previous</a></li><li class="page-item"><a class="page-link border-primary bg-primary text-white"href="#">1</a></li><li class="page-item"><a class="page-link border-primary bg-primary text-white"href="#">2</a></li><li class="page-item"><a class="page-link border-primary bg-primary text-white"href="#">3</a></li><li class="page-item"><a class="page-link border-primary bg-primary text-white"href="#">Next</a></li></ul></nav>
In addition,as pages likely have more than one such navigation section,it’s advisable to provide a descriptive aria-labelfor 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".
Working with icons
<nav aria-label="Page navigation example"><ul class="pagination mb-0"><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>
Looking to use an icon or symbol in place of text for some pagination links? Be sure to provide proper screen reader support with ariaattributes.
Pagination Sizing
<nav aria-label="..."><ul class="pagination pagination-lg"><li class="page-item active"aria-current="page"><span class="page-link">1 <span class="sr-only">(current)</span></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>
Fancy larger or smaller pagination? Add .pagination-lgor .pagination-smfor additional sizes.
Alignment
<h6>left</h6><nav aria-label="Page navigation example"><ul class="pagination"><li class="page-item disabled"><a class="page-link"href="#"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>Change the alignment of pagination components with flexbox utilities.