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".
Different 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.
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.
Using icons
Pagination sizing
Fancy larger or smaller pagination? Add .pagination-lg
or .pagination-sm for additional sizes.