Pagination

Documentation and examples for using Awesome custom progress bars featuring support for stacked bars, animated backgrounds and text labels.

Overview

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="Bootstrap Pagination Example">
                          <ul class="pagination mb-md-0 mr-3">
                            <li class="page-item page-item-prev">
                              <a class="page-link" href="#" aria-label="Previous">
                                Previous
                              </a>
                            </li>
                            <li class="page-item">
                              </a>
                            </li>
                            <li class="page-item active">
                              </a>
                            </li>
                            </li>
                            <li class="page-item d-none d-md-block">
                              </a>
                            </li>
                            <li class="page-item d-none d-md-block">
                              </a>
                            </li>
                            <li class="page-item">
                              </a>
                            </li>
                            <li class="page-item page-item-next">
                              <a class="page-link" href="#" aria-label="Next">
                                Next
                              </a>
                            </li>
                          </ul>
                          </span>
                        </nav>
                      
                    

Working with icons

Are you looking to use an icon or symbol in place of text for some pagination links? Be sure to provide proper screen reader support with aria attributes and the .sr-only utility.

                      
                        <nav aria-label="Bootstrap Pagination Example">
                          <ul class="pagination mb-md-0 mr-3">
                            <li class="page-item page-item-prev">
                              <a class="page-link" href="#" aria-label="Previous">
                                <span class="ti-angle-left"></span>
                              </a>
                            </li>
                            <li class="page-item">
                              <a class="page-link" href="#">1</a>
                            </li>
                            <li class="page-item active">
                              <a class="page-link" href="#">2</a>
                            </li>
                            <li class="page-item d-md-none align-self-center">...</li>
                            <li class="page-item d-none d-md-block">
                              <a class="page-link" href="#">3</a>
                            </li>
                            <li class="page-item d-none d-md-block">
                              <a class="page-link" href="#">4</a>
                            </li>
                            <li class="page-item">
                              <a class="page-link" href="#">5</a>
                            </li>
                            <li class="page-item page-item-next">
                              <a class="page-link" href="#" aria-label="Next">
                                <span class="ti-angle-right"></span>
                              </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="Bootstrap Pagination Example">
                          <ul class="pagination mb-md-0 mr-3">
                            <li class="page-item page-item-prev disabled">
                              <a class="page-link" href="#" aria-label="Previous">
                                <span class="ti-angle-left"></span>
                              </a>
                            </li>
                            <li class="page-item">
                              <a class="page-link" href="#">1</a>
                            </li>
                            <li class="page-item active">
                              <a class="page-link" href="#">2</a>
                            </li>
                            <li class="page-item d-md-none align-self-center">...</li>
                            <li class="page-item d-none d-md-block">
                              <a class="page-link" href="#">3</a>
                            </li>
                            <li class="page-item d-none d-md-block">
                              <a class="page-link" href="#">4</a>
                            </li>
                            <li class="page-item">
                              <a class="page-link" href="#">5</a>
                            </li>
                            <li class="page-item page-item-next">
                              <a class="page-link" href="#" aria-label="Next">
                                <span class="ti-angle-right"></span>
                              </a>
                            </li>
                          </ul>
                        </nav>
                      
                    

Alignment

Change the alignment of pagination components with flexbox utilities.

                      
                        <nav aria-label="Page navigation example">
                          <ul class="pagination justify-content-center">
                            <li class="page-item disabled">
                              <a class="page-link" href="#" tabindex="-1"><span class="ti-angle-left"></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="#"><span class="ti-angle-left"></span></a>
                            </li>
                          </ul>
                        </nav>
                      
                    
                      
                        <nav aria-label="Page navigation example">
                          <ul class="pagination justify-content-end">
                            <li class="page-item disabled">
                              <a class="page-link" href="#" tabindex="-1"><span class="ti-angle-left"></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="#"><span class="ti-angle-left"></span></a>
                            </li>
                          </ul>
                        </nav>
                      
                    

With pager

                      
                        <nav class="d-flex justify-content-between align-items-center" aria-label="Page navigation example">
                          <small class="text-muted">Showing 3 of 8</small>
                          <ul class="pagination">
                            <li class="page-item">
                              <a class="page-link" href="#" aria-label="Previous">
                                <svg class="duik-icon-svg-1x" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="15 18 9 12 15 6"></polyline></svg>
                              </a>
                            </li>
                            <li class="page-item"><a class="page-link" href="#">1</a></li>
                            <li class="page-item active"><a class="page-link" href="#">2</a></li>
                            <li class="page-item"><a class="page-link" href="#">3</a></li>
                            <li class="page-item disabled"><a class="page-link" href="#">3</a></li>
                            <li class="page-item"><a class="page-link" href="#">8</a></li>
                            <li class="page-item">
                              <a class="page-link" href="#" aria-label="Next">
                                <svg class="duik-icon-svg-1x" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="9 18 15 12 9 6"></polyline></svg>
                              </a>
                            </li>
                          </ul>
                        </nav>
                      
                    
                      
                        <nav aria-label="Bootstrap Pager Example">
                          <ul class="pager justify-content-between">
                            <li class="pager-item pager-item-prev">
                              <a class="pager-link disabled" href="#" aria-label="Previous">
                                <span class="ti-angle-left mr-2"></span>
                                Previous
                              </a>
                            </li>
                            <li class="pager-item">
                              <span class="d-none d-sm-inline-block">Page</span>
                              1 of 5
                            </li>
                            <li class="pager-item pager-item-next">
                              <a class="pager-link" href="#" aria-label="Next">
                                Next
                                <span class="ti-angle-right ml-2"></span>
                              </a>
                            </li>
                          </ul>
                        </nav>