Skip to content

Breadcrumb ​

A navigational landmark that shows the user's current location in a hierarchy. Renders a semantic <nav> with an ordered list of ore-breadcrumb-item links, separated by a customizable separator glyph.

Items with Icons ​

Use the icon named slot on any ore-breadcrumb-item for a leading icon. When using icon-only crumbs, provide visible text as the default slot content or add aria-label to the icon wrapper to keep the crumb meaningful to screen readers.

Full width

Custom Separator ​

Use the separator attribute to replace the default / separator. You can also override the --breadcrumb-separator CSS custom property globally in your theme.

Full width

Custom aria-label ​

Override the default "Breadcrumb" landmark label when a page has multiple navigation regions.

Full width

API Reference ​

ore-breadcrumb Attributes

AttributeTypeDefaultDescription
labelstring'Breadcrumb'aria-label applied to the wrapping <nav> landmark
separatorstring'/'Separator glyph rendered between items (also sets --breadcrumb-separator)

ore-breadcrumb Slots

SlotDescription
(default)ore-breadcrumb-item elements representing each crumb

ore-breadcrumb CSS Custom Properties

PropertyDescriptionDefault
--breadcrumb-separatorSeparator character shown between items'/'

ore-breadcrumb-item Attributes

AttributeTypeDefaultDescription
hrefstringN/AURL the item links to. Omit for non-linked crumbs.
activebooleanfalseMarks this item as the current page (aria-current="page"). Disables the link. Always mark the final (current) crumb as active: omitting it breaks aria-current and confuses screen readers. Only one crumb should carry aria-current="page".

ore-breadcrumb-item Slots

SlotDescription
iconOptional leading icon or decoration
(default)Crumb label text

Events

ore-breadcrumb and ore-breadcrumb-item do not emit custom events. Use standard DOM click listeners on individual items if you need to intercept navigation (e.g., in an SPA).

Accessibility ​

The breadcrumb component follows WAI-ARIA best practices. It renders a <nav> element with aria-label matching the label attribute, serving as a navigation landmark. Items are rendered as <li> elements inside an <ol>, conveying the sequential structure to screen readers.

The active item receives aria-current="page" and aria-disabled="true" so it is announced as the current location and not activated when clicked. The separator is rendered via CSS content (or a hidden aria-hidden element) so it is not read aloud. Keep crumb labels short and descriptive: they should match the <title> or <h1> of the destination page, and provide an href on every non-active crumb so keyboard and screen reader users can navigate directly.