BetaPublic beta — Read the release notes
Documentation

Breadcrumb

Keyboard, focus, semantic, and consumer responsibilities for Breadcrumb.

Package
@solidiom/breadcrumb
Version
0.0.1-next.0
Status
stable

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.