v2.0.0-rc.4
Theme

Breadcrumbs

The Breadcrumbs component provides hierarchical navigation to help users understand their current location within a site structure and navigate back to previous levels.

Installation

npm install @duskmoon-dev/el-breadcrumbs

Usage

import '@duskmoon-dev/el-breadcrumbs/register';
<el-dm-breadcrumbs id="breadcrumbs"></el-dm-breadcrumbs>

<script>
  document.querySelector('#breadcrumbs').items = [
    { label: 'Home', href: '/' },
    { label: 'Products', href: '/products' },
    { label: 'Electronics', href: '/products/electronics' },
    { label: 'Laptops' }
  ];
</script>

Live Demo

Breadcrumbs Demo

Properties

PropertyTypeDefaultDescription
itemsBreadcrumbItem[][]Array of breadcrumb items
separatorstring'/'Separator character between items
interface BreadcrumbItem {
  label: string;  // Display label for the breadcrumb
  href?: string;  // URL for the breadcrumb link (optional for last item)
}

Custom Separator

<!-- Text separator -->
<el-dm-breadcrumbs separator=">"></el-dm-breadcrumbs>

<!-- Custom separator via slot -->
<el-dm-breadcrumbs>
  <span slot="separator">
    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor">
      <polyline points="9 18 15 12 9 6"></polyline>
    </svg>
  </span>
</el-dm-breadcrumbs>

Custom Separator

Events

EventDetailDescription
navigate{ item: BreadcrumbItem, index: number }Fired when a breadcrumb link is clicked

Event Handling

const breadcrumbs = document.querySelector('el-dm-breadcrumbs');
breadcrumbs.addEventListener('navigate', (e) => {
  e.preventDefault(); // Prevent default navigation
  console.log('Navigating to:', e.detail.item.href);
  console.log('Item:', e.detail.item);
  console.log('Index:', e.detail.index);
});

Slots

SlotDescription
itemServer-rendered breadcrumb item; repeated items retain their native links and attributes
separatorCustom separator element between items

The final declarative item receives aria-current="page" automatically:

<el-dm-breadcrumbs>
  <span slot="item"><a href="/">Home</a></span>
  <span slot="item"><a href="/components">Components</a></span>
  <span slot="item">Breadcrumbs</span>
</el-dm-breadcrumbs>

CSS Parts

PartDescription
navThe navigation container
listThe ordered list element
itemIndividual breadcrumb item container
linkBreadcrumb link element
currentCurrent page text (last item)
separatorSeparator element between items

Styling Example

el-dm-breadcrumbs::part(link) {
  color: #3b82f6;
  font-weight: 500;
}

el-dm-breadcrumbs::part(link):hover {
  text-decoration: underline;
}

el-dm-breadcrumbs::part(current) {
  color: #6b7280;
}

el-dm-breadcrumbs::part(separator) {
  color: #9ca3af;
  margin: 0 0.25rem;
}

Accessibility

  • Uses <nav> element with aria-label="Breadcrumb"
  • Uses <ol> for semantic list structure
  • Last item has aria-current="page" to indicate current page
  • All links are keyboard accessible
  • Focus indicator for keyboard navigation