pattern-library 2 linked patterns checked
U.S. Web Design System Banner Component
Documents official-site identity banners that appear at the top of every page, use consistent text, avoid misleading use, and include accessibility guidance for labelled banner regions.
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 |
|---|---|---|---|
| Banner | Choose banner when the message scope spans multiple pages, sections, records, or sessions in the same product, service, account, or workspace. | The banner appears before users encounter content affected by the message. | USWDS banner guidance supports consistent top-of-page official identity messages and cautions against misleading use. |
| Official-site banner | Choose official-site banner when a page is eligible to claim official government or public-authority identity and users need to verify domain and secure connection status. | The banner appears before the header, service navigation, site alerts, notification banners, and main content. | Supports official-site identity, .gov explanation, secure HTTPS explanation, top placement, and accessibility guidance. |
Comparisons supported by this source
- Banner vs alert vs inline message vs toast notification
USWDS banner guidance covers top-of-page official-site identity, consistency, and avoiding misleading banner use.
- Official-site banner vs banner vs site alert vs notification banner vs security warning vs service navigation
Supports official-site identity, .gov explanation, secure HTTPS explanation, top placement, and accessibility guidance.
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: .