PAGINATION

When to Use

Example: table footer

  • Paginated lists, tables, or search results
  • When data sets are too large to display on a single page
  • When users need to navigate between discrete pages of content

Usage Guidelines

DO

Use brand style for primary navigation, default for secondary contexts. Set siblings to control how many page numbers appear around the current page. Use simple mode for mobile layouts

Don’t

Don't use pagination when infinite scroll is more appropriate. Don't show pagination for single-page results

Accessibility

  • Root element: <nav role="navigation" aria-label="Pagination">
  • Current page button: aria-current="page"
  • Previous / Next buttons: aria-label="Previous page" / aria-label="Next page"
  • disabled attribute prevents pointer events automatically
  • Full keyboard navigation with focus-visible ring