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

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 - 图2

  1. <nav aria-label="Page navigation example">
  2. <ul class="pagination">
  3. <li class="page-item">
  4. <a class="page-link" href="#" aria-label="Previous">
  5. <span aria-hidden="true">&laquo;</span>
  6. </a>
  7. </li>
  8. <li class="page-item"><a class="page-link" href="#">1</a></li>
  9. <li class="page-item"><a class="page-link" href="#">2</a></li>
  10. <li class="page-item"><a class="page-link" href="#">3</a></li>
  11. <li class="page-item">
  12. <a class="page-link" href="#" aria-label="Next">
  13. <span aria-hidden="true">&raquo;</span>
  14. </a>
  15. </ul>
  16. </nav>

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 - 图4

  1. <nav aria-label="...">
  2. <ul class="pagination">
  3. <li class="page-item disabled">
  4. <span class="page-link">Previous</span>
  5. </li>
  6. <li class="page-item"><a class="page-link" href="#">1</a></li>
  7. <li class="page-item active" aria-current="page">
  8. <span class="page-link">2</span>
  9. </li>
  10. <li class="page-item"><a class="page-link" href="#">3</a></li>
  11. <li class="page-item">
  12. <a class="page-link" href="#">Next</a>
  13. </li>
  14. </ul>
  15. </nav>

Pagination - 图6

  1. <nav aria-label="...">
  2. <li class="page-item active" aria-current="page">
  3. <span class="page-link">1</span>
  4. </li>
  5. <li class="page-item"><a class="page-link" href="#">2</a></li>
  6. <li class="page-item"><a class="page-link" href="#">3</a></li>
  7. </ul>
  8. </nav>

Change the alignment of pagination components with .

  1. <nav aria-label="Page navigation example">
  2. <ul class="pagination justify-content-end">
  3. <li class="page-item disabled">
  4. <a class="page-link" href="#" tabindex="-1" aria-disabled="true">Previous</a>
  5. </li>
  6. <li class="page-item"><a class="page-link" href="#">1</a></li>
  7. <li class="page-item"><a class="page-link" href="#">2</a></li>
  8. <li class="page-item"><a class="page-link" href="#">3</a></li>
  9. <li class="page-item">
  10. <a class="page-link" href="#">Next</a>
  11. </li>
  12. </nav>