Breadcrumb
A breadcrumb is a path of links that shows the current page and its parent pages.
A real example
Home / Components / Navigation / Breadcrumb shows where this page sits in the documentation.
Main parts
- 01Current location
- 02Destination labels
- 03Focus order
- 04Responsive behavior
Use it when
Use it on deep sites when people often need to move up one or more levels.
Do not use it when
Never use it on a flat site or as a replacement for browser history.
Name used in code
<nav aria-label="Breadcrumb"> Before you ship
Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states.
Outcome: Use Breadcrumb to solve this user need without losing the current context. User context: Home / Components / Navigation / Breadcrumb shows where this page sits in the documentation. Recommended pattern: Breadcrumb. Why it fits: Use it on deep sites when people often need to move up one or more levels. Do not use it when: Never use it on a flat site or as a replacement for browser history. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): It is official for that source. Other platforms or teams may use the term in another way. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Breadcrumb. Definition: A breadcrumb is a path of links that shows the current page and its parent pages. Release checks: Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.