pattern-library checked

USWDS Pagination

Documents bounded pagination behavior including current page highlighting, first/current/previous/next/last visibility, hiding unavailable previous or next links at edges, and robust current-page links.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Pagination Choose pagination when result order, bounded position, and resumability matter. Changing page updates the collection while preserving the user's query or filters. USWDS documents bounded sets, current page highlighting, first/current/previous/next/last visibility, and edge behavior.
Pagination without current page Flag this anti-pattern when a pagination set has no visible current page, no aria-current or equivalent current-state text, or more than one item that appears current. Each pagination region has one owner collection and one current page or current range. Supports bounded pagination, current-page highlighting, previous/next visibility, and robust current-page links.

Evidence Role

This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: U.S. Web Design System. Last checked: .