#### 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-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"`.

#### 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 `.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.

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-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"`.

#### 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">&laquo;</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">&raquo;</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 `aria` attributes.

#### 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-lg` or `.pagination-sm` for 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.

###### left

###### Center

###### Right