Breadcrumbs prints the trail to the current page in the label role: ancestors as underlined links, the current page last as plain text, 10 px play glyphs between them. Below the sm container width only the parent shows, as a back step. Crumbs print in the ink, never the secondary ink (D-N104).
Example#
Usage#
Use breadcrumbs on pages that sit deep in a hierarchy, such as a case study inside Work: the trail from the top section to here. Top-level pages need none.
- Items. Ancestors are links; the current page is last, as plain text with
aria-current="page". - Phones. Below the sm width only the parent shows, as a back step.
Anatomy#
- Link
data-mk-part="link" - SeparatorA 10 px play glyph, hidden from assistive tech.
.mk-breadcrumbs-separator - Current
data-mk-part="current"
Volume#
Reading layer: identical at every volume.
Quiet
Studio
Press
Rave
Content#
- Use the pages' own titles, shortened only if they are long.
- Never put the site's name or "Home" first when the logo already links home.
Do and don't#
Do
Don't
Accessibility#
- A
navnamed "Breadcrumb" around an ordered list; the current page carriesaria-current="page"and is not a link. - The separators are hidden from assistive tech and mirror under
dir="rtl". - Links are underlined, so they read as links without colour.
| Keys | What happens |
|---|---|
| Tab | Moves through the ancestor links; the current page is not a stop |
The colour pairs it prints, with their contrast on both papers:
| Text | Surface | Role | Bone | Night |
|---|---|---|---|---|
--mk-text | --mk-surface | ui | not in this look | not in this look |
Props#
| Prop | Type | Default | Description |
|---|---|---|---|
items required | readonly BreadcrumbItem[] | none | Ancestors first, the current page last. |
label | string | "Breadcrumb" | The landmark's name (default "Breadcrumb"). |
Tokens#
System tokens (5)
Changelog#
Arrived in 0.9.0.
Breadcrumbs,Pagination(withpaginationRange),Count,ProgressBar(bar, segments, indeterminate),AvatarandAvatarGroup,Tick,EmptyState,Kbd,SkeletonandLoader. Read the whole entry