pattern-library checked
U.S. Web Design System Button group
Documents button groups for contextually related actions, linear navigation actions such as Back and Continue, grouping semantics, responsive vertical stacking, segmented button groups, and cautions against unrelated or destructive action mixing.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Button group | Choose a button group when two to four actions are contextually related and should be considered together at one workflow moment. | Each button performs a command immediately or starts a named flow; buttons in the group do not represent persistent selected values unless the component is intentionally a segmented or toggle group. | USWDS documents button groups for related actions, Back and Continue flows, group semantics, responsive stacking, and cautions against unrelated or destructive action mixing. |
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: .