Breadcrumb

Navigation aid showing the current page's location within a hierarchy.

Default

Simple breadcrumb with chevron separators.

html
<nav aria-label="Breadcrumb">
  <ol class="uc-flex uc-items-center uc-gap-1.5">
    <li><a href="#" class="uc-text-sm uc-text-fg-disabled">Home</a></li>
    <li><svg class="uc-w-4 uc-h-4">...</svg></li>
    <li><span class="uc-text-sm uc-font-medium">Current</span></li>
  </ol>
</nav>

With Slash Separator

Uses a forward slash as the separator between items.

html
<nav aria-label="Breadcrumb">
  <ol class="uc-flex uc-items-center uc-gap-1.5">
    <li><a href="#" class="uc-text-sm uc-text-fg-disabled">Home</a></li>
    <li><span class="uc-text-fg-disabled/60 uc-mx-1.5 uc-text-sm">/</span></li>
    <li><a href="#" class="uc-text-sm uc-text-fg-disabled">Products</a></li>
    <li><span class="uc-text-fg-disabled/60 uc-mx-1.5 uc-text-sm">/</span></li>
    <li><span class="uc-text-sm uc-font-medium">T-Shirts</span></li>
  </ol>
</nav>

With Icons

Breadcrumb items accompanied by descriptive icons.

html
<nav aria-label="Breadcrumb">
  <ol class="uc-flex uc-items-center uc-gap-1.5">
    <li>
      <a href="#" class="uc-inline-flex uc-items-center uc-gap-1.5 uc-text-sm uc-text-fg-disabled">
        <svg class="uc-w-4 uc-h-4">...</svg>
        Home
      </a>
    </li>
    <li><svg class="uc-w-4 uc-h-4">...</svg></li>
    <li><span class="uc-text-sm uc-font-medium">Current</span></li>
  </ol>
</nav>

Truncated

Long breadcrumb paths are collapsed with an ellipsis to save space.

html
<nav aria-label="Breadcrumb">
  <ol class="uc-flex uc-items-center uc-gap-1.5">
    <li><a href="#" class="uc-text-sm uc-text-fg-disabled">Home</a></li>
    <li><svg class="uc-w-4 uc-h-4">...</svg></li>
    <li><button class="uc-w-8 uc-h-8 uc-rounded-lg"><svg class="uc-w-4 uc-h-4"><!-- ... --></svg></button></li>
    <li><svg class="uc-w-4 uc-h-4">...</svg></li>
    <li><span class="uc-text-sm uc-font-medium">Current</span></li>
  </ol>
</nav>

With Dropdown

A breadcrumb item with a dropdown indicator for selecting alternative paths.

html
<nav aria-label="Breadcrumb">
  <ol class="uc-flex uc-items-center uc-gap-1.5">
    <li><a href="#" class="uc-text-sm uc-text-fg-disabled">Home</a></li>
    <li><svg class="uc-w-4 uc-h-4">...</svg></li>
    <li class="uc-relative">
      <button class="uc-inline-flex uc-items-center uc-gap-1 uc-text-sm uc-text-fg-disabled">
        Products
        <svg class="uc-w-3.5 uc-h-3.5">...</svg>
      </button>
      <div class="uc-absolute uc-top-full uc-left-0 uc-mt-1.5 uc-w-44 uc-rounded-lg uc-border uc-bg-neutrals-surface uc-shadow-lg uc-py-1">
        <a href="#" class="uc-block uc-px-3 uc-py-1.5 uc-text-sm">Electronics</a>
      </div>
    </li>
    <li><svg class="uc-w-4 uc-h-4">...</svg></li>
    <li><span class="uc-text-sm uc-font-medium">T-Shirts</span></li>
  </ol>
</nav>

API Reference

All utility classes available for the Breadcrumb component.

Class Type Description
uc-flex uc-items-center uc-gap-1.5 Base Horizontal layout for the breadcrumb list
uc-inline-flex uc-items-center Base Inline alignment for each breadcrumb item
uc-text-sm Base Default text size for breadcrumb links and labels
uc-text-fg-disabled Base Muted color for non-current breadcrumb links
uc-text-fg-primary State Primary color for the current (last) breadcrumb item
uc-font-medium State Medium font weight for the current page label
uc-text-fg-disabled/60 Base Faded separator color for chevrons or slashes
uc-hover:text-fg-primary Modifier Hover state for breadcrumb links
uc-transition-colors Modifier Smooth color transition on hover
uc-hidden State Hides dropdown menu by default

Accessibility

Keyboard and screen reader support.

Feature Details
Navigation Wrap in nav element with aria-label="Breadcrumb"
Current page Last item should have aria-current="page"
Separators Visual separators should be aria-hidden="true"
Keyboard All links are focusable and activatable via Enter