Breadcrumb
Breadcrumbs show the current page location within a navigational hierarchy.
Anatomy
| Element | Part | Selector |
|---|---|---|
<nav> | root | [data-scope="breadcrumb"][data-part="root"]LMBCopy |
<ol> | list | [data-scope="breadcrumb"][data-part="list"]LMBCopy |
<li> | item | [data-scope="breadcrumb"][data-part="item"]LMBCopy |
<span> | ellipsisconditional | [data-scope="breadcrumb"][data-part="ellipsis"]LMBCopy |
<span> | separator | [data-scope="breadcrumb"][data-part="separator"]LMBCopy |
API
Breadcrumb
Props
| Name | Description | Default | Control |
|---|---|---|---|
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
| Name | Type | Description |
|---|---|---|
itemClick | [event: MouseEvent, item: BreadcrumbItem, index: number] | - |
Slots4
| Name | Parameters | Description |
|---|---|---|
default | - | Fully custom breadcrumb content. When provided, items are not rendered. |
item | - | Custom item content. |
separator | - | Custom separator content. |
ellipsis | - | Custom ellipsis content. |
Styling10
| Token | Description |
|---|---|
--md-breadcrumb-current-page-colorColorFallback var(--md-color-on-container, var(--md-sys-color-on-surface)) | Controls current page text color. |
--md-breadcrumb-ellipsis-colorColorFallback var(--md-color-on-container, var(--md-sys-color-on-surface-variant)) | Controls ellipsis color. |
--md-breadcrumb-item-heightLayoutFallback --dp(32) | Controls item height. |
--md-breadcrumb-item-spaceLayoutFallback --dp(4) | Controls space between items. |
--md-breadcrumb-link-colorColorFallback var(--md-color-on-container, var(--md-sys-color-primary)) | Controls link text color. |
--md-breadcrumb-link-padding-inlineLayoutFallback --dp(8) | Controls link inline padding. |
--md-breadcrumb-link-shapeShapeFallback var(--md-shape-action) | Controls link shape. |
--md-breadcrumb-separator-colorColorFallback var(--md-color-on-container, var(--md-sys-color-on-surface-variant)) | Controls separator color. |
--md-breadcrumb-separator-icon-sizeLayoutFallback --dp(18) | Controls separator and ellipsis icon size. |
--md-breadcrumb-state-layer-colorColorFallback var(--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.