Breadcrumb
Shows the current location in a navigation hierarchy.
When to use
Use breadcrumbs to show a page’s position within a hierarchy and provide links to its ancestors. Keep primary destinations in the Navbar; breadcrumbs describe the current location.
Default
<nav aria-label="Breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="/">Home</a></li>
<li class="breadcrumb-item is-active" aria-current="page">Library</li>
</ol>
</nav>Current page and hierarchy
The final item represents the current page. Add intermediate ancestor links between Home and that item for deeper hierarchies; keep only the current item marked with aria-current="page".
Accessibility and behavior
- Use a labelled
navand an ordered list in parent-to-child order. Different navigation landmarks should have distinct accessible names. - Mark the current page with
aria-current="page"and visible text. Ancestors are ordinary links with meaningful destinations. - Separators are decorative. Preserve link focus indicators and allow long labels to wrap without hiding hierarchy information.
CSS variables
Override these base defaults on the listed selector after the library styles. Variants and states may replace them; global tokens follow the active theme.
| Token | Default | Purpose | Scope / state |
|---|---|---|---|
--breadcrumb-padding-x | var(--spacer-0) | Left and right padding. | .breadcrumb |
--breadcrumb-padding-y | var(--spacer-0) | Top and bottom padding. | .breadcrumb |
--breadcrumb-divider-color | var(--text-subtle) | Separator color. | .breadcrumb |
--breadcrumb-item-padding-x | var(--spacer-2) | Space on either side of a separator. | .breadcrumb |
--breadcrumb-item-active-color | var(--text-muted) | Current breadcrumb text color. | .breadcrumb |