pattern-library 1 linked patterns 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.
Read with a purpose
What this source can teach
Use this source to compare a documented solution with the task and states in your own product.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
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. |
Comparisons supported by this source
- Button group vs segmented control vs menu button vs confirmation dialog
USWDS defines button groups as related actions, covers Back and Continue-style flows, grouping semantics, responsive stacking, and cautions about unrelated or destructive actions.
Evidence Role
This source is treated as pattern-library evidence. Its value comes from the specific claims and setting described above.
Publisher: U.S. Web Design System. Last checked: .