- Home
- Primitives
- Breadcrumb
- Accessibility
Breadcrumb
Keyboard, focus, semantic, and consumer responsibilities for Breadcrumb.
Accessibility
Accessibility contract
Semantics
- Renders the root as a `<nav>` element with `aria-label="Breadcrumb"`.
- Renders items within an `<ol>` list structure for proper semantic ordering.
- Each breadcrumb entry is an `<li>` containing a navigation link.
- The current page link carries `aria-current="page"` to indicate the active location.
- Separator and Ellipsis render with `role="presentation"` and `aria-hidden="true"` (Separator) to hide decorative content from the accessibility tree.
- Carries `data-scope="breadcrumb"` and `data-part` attributes on all parts.
ARIA
- `aria-label="Breadcrumb"` on the `<nav>` identifies the navigation region for screen readers.
- `aria-current="page"` on the current page link indicates the user's present location in the hierarchy.
- `role="presentation"` on Separator and Ellipsis removes decorative elements from the accessibility tree.
- `aria-hidden="true"` on Separator ensures the visual divider is not announced.
Consumer responsibilities
- Use Breadcrumb to represent the user's current location within a navigational hierarchy.
- Set `current` on the `Link` that corresponds to the current page.
- Use `Ellipsis` to indicate omitted intermediate levels in deeply nested hierarchies.
- Ensure all `Link` elements have meaningful text content for screen reader users.
Not applicable
- keyboard
- Breadcrumb relies on standard anchor element keyboard interactions (Tab/Enter/Space); no custom keyboard handling is required.
- focus
- Breadcrumb relies on standard anchor element focus management; no custom focus handling is required.
Review status: Draft — not yet reviewed
This contract describes what the primitive guarantees. Consuming products remain responsible for labels, layout, and workflow decisions that affect the final accessibility result.
Automated evidence
Axe scan summary
- Passes
- 12
- Violations
- 0
- Incomplete
- 0
Latest executed scan: Aug 13, 2026, 10:47 PM
Evidence IDs: axe-breadcrumb-scan-v1
Automated checks cover only the recorded fixture and do not establish complete accessibility conformance.