GitHubopen_in_new

Breadcrumb

Breadcrumbs show the current page location within a navigational hierarchy.

Anatomy

ElementPartSelector
<nav>
root
[data-scope="breadcrumb"][data-part="root"]
left_clickLMBCopy
<ol>
list
[data-scope="breadcrumb"][data-part="list"]
left_clickLMBCopy
<li>
item
[data-scope="breadcrumb"][data-part="item"]
left_clickLMBCopy
<span>
ellipsisconditional
[data-scope="breadcrumb"][data-part="ellipsis"]
left_clickLMBCopy
<span>
separator
[data-scope="breadcrumb"][data-part="separator"]
left_clickLMBCopy

API

Props

NameDescriptionDefaultControl
ariaLabelOptional

Accessible label for the breadcrumb navigation landmark.

string | undefined
"Breadcrumb"
itemsOptional

Breadcrumb items. The last item is treated as the current page by default.

BreadcrumbItem[] | undefined
[]
-
separatorIconOptional

Material Symbols icon used between items.

string | undefined
"chevron_right"
ellipsisLabelOptional

Accessible label for ellipsis items.

string | undefined
"More items"

Events1

NameTypeDescription
itemClick[event: MouseEvent, item: BreadcrumbItem, index: number]-

Slots4

NameParametersDescription
default-Fully custom breadcrumb content. When provided, items are not rendered.
item-Custom item content.
separator-Custom separator content.
ellipsis-Custom ellipsis content.

Styling10

TokenDescription
--md-breadcrumb-current-page-colorColor
Fallbackvar(--md-color-on-container, var(--md-sys-color-on-surface))

Controls current page text color.

--md-breadcrumb-ellipsis-colorColor
Fallbackvar(--md-color-on-container, var(--md-sys-color-on-surface-variant))

Controls ellipsis color.

--md-breadcrumb-item-heightLayout
Fallback--dp(32)

Controls item height.

--md-breadcrumb-item-spaceLayout
Fallback--dp(4)

Controls space between items.

--md-breadcrumb-link-colorColor
Fallbackvar(--md-color-on-container, var(--md-sys-color-primary))

Controls link text color.

--md-breadcrumb-link-padding-inlineLayout
Fallback--dp(8)

Controls link inline padding.

--md-breadcrumb-link-shapeShape
Fallbackvar(--md-shape-action)

Controls link shape.

--md-breadcrumb-separator-colorColor
Fallbackvar(--md-color-on-container, var(--md-sys-color-on-surface-variant))

Controls separator color.

--md-breadcrumb-separator-icon-sizeLayout
Fallback--dp(18)

Controls separator and ellipsis icon size.

--md-breadcrumb-state-layer-colorColor
Fallbackvar(--md-state-layer-color, var(--md-breadcrumb-link-color))

Controls link state layer color.

Examples

Default

Collapsed

Custom Separator

Vue Router

Use @item-click to bridge item clicks into your router.