Tessera UI

Breadcrumb

Navigation trail showing the user's location in a hierarchy, with support for collapsed items, custom separators, and RTL.

Installation

pnpm add @tessinaui/ui

Usage

import {
  Breadcrumb,
  BreadcrumbList,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbPage,
  BreadcrumbSeparator,
  BreadcrumbEllipsis,
} from "@tessinaui/ui";
<Breadcrumb>
  <BreadcrumbList>
    <BreadcrumbItem>
      <BreadcrumbLink href="/">Home</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbLink href="/components">Components</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
    </BreadcrumbItem>
  </BreadcrumbList>
</Breadcrumb>

Playground

Preview

Showcase

Preview

API Reference

Renders a <nav aria-label="Breadcrumb"> element.

PropTypeDefaultDescription
size"xs" | "sm" | "md" | "lg" | "xl""md"Scales text and separator icon size
separator"chevron" | "slash""chevron"Auto-rendered separator type when BreadcrumbSeparator has no children
dir"ltr" | "rtl""ltr"Text direction — in RTL the chevron separator rotates 180°
backgroundbooleanfalseWraps the breadcrumb in a bg-secondary rounded-full pill with size-appropriate padding

Renders an <ol> element. Accepts all standard list HTML attributes.

Renders a <li> element. Accepts all standard list item HTML attributes.

PropTypeDefaultDescription
hrefstringLink destination
disabledbooleanfalseMutes the link and removes pointer events

Accepts all standard anchor HTML attributes.

Renders the current page as a <span> with aria-current="page" and aria-disabled="true". Accepts all standard span HTML attributes.

Renders a <li role="presentation" aria-hidden="true">. When empty, auto-renders the separator type configured on Breadcrumb. Pass children to render a custom separator:

<BreadcrumbSeparator>
  <span aria-hidden="true">·</span>
</BreadcrumbSeparator>

Renders a <span> with a MoreHorizontal icon, sized to match the current size. Accepts all standard span HTML attributes.

On this page