pattern-library 1 linked patterns checked
U.S. Web Design System Tag Component
Documents tags for drawing attention to new or categorized content, filtering results, unread counts, confusion with buttons, static versus interactive behavior, restraint, and live-region handling for dynamically loaded tagged content.
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 |
|---|---|---|---|
| Tag / status tag | Choose tag when the label is compact, read-only, attached to a visible object, and useful for scanning or comparison. | A read-only tag does not receive focus, show hover affordance, expose pressed or selected state, or claim click behavior. | USWDS documents tags for categorized, new, filtered, and unread-count content with guidance against confusing static tags with controls. |
Comparisons supported by this source
- Tag vs filter chips vs chip selection vs inline message
USWDS documents tags for new, categorized, filtered, and unread-count content with usability guidance against confusing static tags with controls.
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: .