Skip to content

Breadcrumb

Breadcrumbs show the current page's hierarchical location within a site or application, helping users understand the structure and navigate quickly.

Basic Usage

Pass an array of breadcrumb items via the items prop. Set active on the last item to mark the current page.

vue

<TBreadcrumb :items="[
  { text: 'Home', href: '#/' },
  { text: 'Library', href: '#/library' },
  { text: 'Data', active: true },
]"/>

Separator Styles

The separator prop changes the separator style: dots, arrows, or bullets.

Dots

vue

<TBreadcrumb separator="dots" :items="[
  { text: 'Home', href: '#' },
  { text: 'Library', href: '#' },
  { text: 'Data', active: true },
]"/>

Arrows

vue

<TBreadcrumb separator="arrows" :items="[
  { text: 'Home', href: '#' },
  { text: 'Library', href: '#' },
  { text: 'Data', active: true },
]"/>

Bullets

vue

<TBreadcrumb separator="bullets" :items="[
  { text: 'Home', href: '#' },
  { text: 'Library', href: '#' },
  { text: 'Data', active: true },
]"/>

With Icons

Each breadcrumb item accepts an icon prop to pass an icon component from @tabler/icons-vue.

vue

<TBreadcrumb :items="[
    { text: 'Home', href: '/', icon: IconHome },
    { text: 'Library', href: '#', icon: IconFolder },
    { text: 'Data', active: true, icon: IconFile },
  ]"></TBreadcrumb>

Muted Style

Set the muted prop to apply a subdued visual style, suitable for secondary navigation areas.

vue

<TBreadcrumb muted :items="[
  { text: 'Home', href: '#' },
  { text: 'Library', href: '#' },
  { text: 'Data', active: true },
]"/>

API

Props

PropDescriptionTypeDefault
itemsArray of breadcrumb itemsBreadcrumbItem[][]
separatorSeparator style'default' | 'dots' | 'arrows' | 'bullets''default'
mutedEnable subdued visual stylebooleanfalse
PropertyDescriptionTypeDefault
textDisplay textstring
hrefLink URL (renders as <span> when omitted)stringundefined
iconIcon componentComponentundefined
activeWhether the item is active (current page)booleanfalse

Slots

SlotDescription
item-{index}Custom content for a single breadcrumb item, scoped with { item }