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