Skip to content
Velkin LogoVelkin Logo
Velkin
VELKIN/UI

Modern UI components for product teams and their AI agents. Lit core, typed wrappers, live MCP.

sales@velkinui.com

Product

  • Docs
  • Components
  • Studio
  • Pricing

Resources

  • Quick start
  • Blog
  • Changelog
  • Roadmap
  • Status

Project

  • About
  • Contact
  • License
  • Privacy
  • Terms

© 2026 Velkin. MIT core · Pro licenses available.

VELKIN

Breadcrumb

A breadcrumb component for navigation trails with optional collapse.

vu-breadcrumb · @velkin/react/breadcrumb

Copy page

Import

React
npm i @velkin/react

import { VuBreadcrumb } from "@velkin/react/breadcrumb";

Examples

API

Tables match the member selected under Import.

Props

PropTypeDefaultDescription
separatorstring"/"Glyph between items; forwarded via `--breadcrumb-separator`. Default: `"/"`.
sizeVuBreadcrumbSize"md"Typography scale forwarded to children. Default: `"md"`.
maxnumber0Collapse threshold; `0` never collapses by count. Default: `0`.
itemsBeforenumber1Leading items kept when collapsed; HTML attribute is `itemsbefore`. Default: `1`.
itemsAfternumber1Trailing items kept when collapsed; HTML attribute is `itemsafter`. Default: `1`.
responsivebooleanfalseAuto-collapse when the trail no longer fits. Default: `false`.
overflowVuBreadcrumbOverflow"menu"Hidden-segment UI (`menu` | `inline`). Default: `"menu"`.
expandedbooleanfalseSuspends collapse and reveals every item. Default: `false`.
showExpandActionbooleantrueFooter action to reveal the full trail when `overflow="menu"`. Default: `true`.
expandActionLabelstring""Footer action label; empty uses the locale catalog.
disabledbooleanfalseDims the trail and disables pointer events. Default: `false`.
labelstring""Accessible name for the wrapping `<nav>`. Default: `"Breadcrumb"`.

Events

EventDetailDescription
vu-revealVuBreadcrumbRevealDetailFired when the full trail is revealed (`overflow="inline"` ellipsis click, or "Show full trail" in the menu).

Slots

SlotDescription
—- One or more `<vu-breadcrumb-item>` children, in hierarchy order (root → leaf).

CSS parts

PartDescription
baseThe `<nav>` wrapper.
listThe `role="list"` container holding items + ellipsis.
ellipsisThe `<li>` housing the overflow trigger; only present while collapsed.
ellipsis-separatorThe leading separator inside the ellipsis tile.
ellipsis-buttonThe clickable button that opens the overflow menu or expands inline.
overflow-menuThe popover panel listing hidden segments (`overflow="menu"` only).
overflow-itemEach row button inside the overflow menu.
overflow-dividerSeparator before the optional expand footer.
overflow-expandFooter button that sets `expanded` to show the full trail.

Types

NameDefinition
VuBreadcrumbOverflow
"menu" | "inline"
VuBreadcrumbSize
"sm" | "md" | "lg"

Related

Companions

  • Breadcrumb Item`vu-breadcrumb-item`

Navigation

  • Adaptive BarA responsive toolbar component that overflows extra items into a menu.
  • AppbarAn application bar component with start, center, and end slots.
  • Context MenuA context menu component with grouped actions and icons.
  • DropdownA dropdown menu component with trigger slot and keyboard navigation.
  • MenubarA menubar component with nested submenus and keyboard navigation.
  • Nav PanelA navigation panel component for drawer bodies with icon-rail collapse.

Guides

  • AccessibilityFocus and naming
  • SlotsHeader, body, and item slots

Browse

  • Previous: AppbarEarlier in the sidebar
  • Next: Context MenuLater in the sidebar
  • All componentsBrowse the full index