Component

Breadcrumbs

A breadcrumb navigation trail. Auto-generated from pathname or manually specified items. Uses the headless @refraction-ui/breadcrumbs core.

Examples

Auto-generated, custom labels, and manual breadcrumbs.

Auto-generated from path
With custom labels
Manual items

Installation

$pnpm add @refraction-ui/react-breadcrumbs

Usage

tsx
import { Breadcrumbs } from '@refraction-ui/react-breadcrumbs'

export function MyComponent() {
  return <Breadcrumbs pathname="/docs/components/button" />
}

Props

PropTypeDefaultDescription
pathnamestring--Auto-generate breadcrumbs from this pathname.
itemsBreadcrumbItem[]--Manual breadcrumb items (overrides pathname).
labelsRecord<string, string>--Custom label map for pathname segments.
separatorstring'/'Separator character between items.
maxItemsnumber--Max items before truncation.
classNamestring--Additional CSS classes.