Components
Breadcrumb
Show the current page's place in a hierarchy with a list of links and a CSS-driven divider.
How it works
A breadcrumb is an ordered list inside a <nav>. The divider between items is generated by
CSS from --bs-breadcrumb-divider, so it never ends up in the accessible name or the copied
text. The theme's default divider is › (a single right-pointing angle quote) rather than
Bootstrap's /.
Example
Mark the current page with .active and aria-current="page".
HTML
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item active" aria-current="page">Home</li>
</ol>
</nav>
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Home</a></li>
<li class="breadcrumb-item"><a href="#!">Library</a></li>
<li class="breadcrumb-item active" aria-current="page">Data</li>
</ol>
</nav>HTML
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Results</a></li>
<li class="breadcrumb-item"><a href="#!">1991</a></li>
<li class="breadcrumb-item"><a href="#!">Summer Spectacular</a></li>
<li class="breadcrumb-item active" aria-current="page">Main event</li>
</ol>
</nav>Dividers
Change the divider by setting --bs-breadcrumb-divider on the .breadcrumb (or any
ancestor). It takes anything valid in content: a quoted string, an embedded SVG, or
'' to remove it.
HTML
<nav style="--bs-breadcrumb-divider: '>';" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>The stock Bootstrap slash:
HTML
<nav style="--bs-breadcrumb-divider: '/';" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>An embedded SVG chevron. Encode the # as %23 and quote the whole URL:
HTML
<nav style="--bs-breadcrumb-divider: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath d='M2.5 0L1 1.5 3.5 4 1 6.5 2.5 8l4-4-4-4z' fill='%235a73a8'/%3E%3C/svg%3E");" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>Remove the divider with an empty string:
HTML
<nav style="--bs-breadcrumb-divider: '';" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#!">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>
To change the default for the whole site, set $breadcrumb-divider in Sass. The theme sets it
to quote(›) in scss/_variables.scss. Set $breadcrumb-divider-flipped
too if you compile an RTL build and the glyph has a direction.
$breadcrumb-divider: quote(›); // theme default
$breadcrumb-divider: quote(">");
$breadcrumb-divider: none; // no divider
Accessibility
- Wrap the list in
<nav aria-label="breadcrumb">so it is announced as a navigation landmark. - Put
aria-current="page"on the last item. The.activeclass only styles it. - Dividers are CSS-generated content and are not read aloud or copied.
CSS
All of Bootstrap's --bs-breadcrumb-* variables apply.
.breadcrumb {
--bs-breadcrumb-padding-x: 0;
--bs-breadcrumb-padding-y: 0;
--bs-breadcrumb-margin-bottom: 1rem;
--bs-breadcrumb-divider-color: var(--bs-secondary-color); // navy-300 in light
--bs-breadcrumb-item-padding-x: 0.5rem;
--bs-breadcrumb-item-active-color: var(--bs-secondary-color);
}
.breadcrumb-item + .breadcrumb-item::before {
content: var(--bs-breadcrumb-divider, "›");
}