pattern-library checked

U.S. Web Design System Table

Documents sortable table columns, aria-sort defaults, live announcements for sort state changes, sortable header behavior, and raw sort values for formatted numbers, dates, months, percentages, and file sizes.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Sort controls Choose sort controls when the same result set can be usefully ordered by two or more meaningful attributes. Changing a Sort by select applies the new order to the full current result set and keeps unrelated query and filter state intact. USWDS documents table sort accessibility, aria-sort state, live announcements, and raw sortable values.
Table Choose table when each row represents one record and each column represents the same attribute for every row. The table caption or nearby heading names the dataset and purpose, not just Table. USWDS table guidance supports responsive, stacked, sortable, and stateful table behavior.

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