Skip to content

Breadcrumb

Breadcrumb

Navigation component for showing the current page location in a hierarchical structure.

Import

import { Breadcrumb } from '@primitivekit/vanilla';

Basic Usage

const breadcrumb = new Breadcrumb({ /* options */ });
document.body.appendChild(breadcrumb.element);

Props

No props available.

Customization

The Breadcrumb component supports CSS variables for complete customization:

const breadcrumb = new Breadcrumb({
  style: {
    '--breadcrumb-bg-color': '#007bff',
    '--breadcrumb-text-color': '#ffffff'
  }
});

Design Tokens

The following design tokens are available for customization:

  • --breadcrumb-bg-color
  • --breadcrumb-padding-top
  • --breadcrumb-padding-y
  • --breadcrumb-padding-right
  • --breadcrumb-padding-x
  • --breadcrumb-padding-bottom
  • --breadcrumb-padding-left
  • --breadcrumb-gap
  • --breadcrumb-item-color
  • --breadcrumb-item-color-hover
  • … and 34 more

Accessibility

The Breadcrumb component is fully accessible and follows WCAG 2.1 AA standards:

  • ✅ Semantic HTML elements
  • ✅ Keyboard accessible
  • ✅ Focus visible indicator
  • ✅ Proper ARIA attributes
  • ✅ Screen reader compatible
  • ✅ Touch target size (44x44px minimum)
  • ✅ Color contrast compliance

Keyboard Navigation

KeyAction
TabMove focus to/from component
EnterActivate component
SpaceActivate component

Related Components

  • Link - Navigation component for creating accessible hyperlinks with various styles.
  • Tabs - Navigation component for organizing content into multiple panels with tab selection.
  • Menu - Navigation component for displaying a list of actions or navigation links.
  • Steps - Navigation component for showing progress through a multi-step process or wizard.
  • Pagination - Navigation component for splitting content across multiple pages with page controls.

See Also