Skip to main content
← All Demos

Breadcrumb

Breadcrumb shows the current location in a hierarchy and helps users navigate back through parent levels.

1. Basic Breadcrumb

Standard breadcrumb trail with links and a current page. Screen readers announce the nav landmark and each link; the last item is marked with aria-current="page".

Keyboard: Tab through links → Enter/Space to activate → Current page is not focusable
<Breadcrumb.Root>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='/home'>Home</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Page>Widget</Breadcrumb.Page>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

2. With Navigation Handler

Root onNavigate intercepts all link clicks for SPA routing integration.

<Breadcrumb.Root onNavigate={(href, e) => e.preventDefault()}>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='/dashboard'>Dashboard</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='/dashboard/settings'>Settings</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Page>Profile</Breadcrumb.Page>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

3. Custom Separators

Separators are decorative and hidden from screen readers via aria-hidden="true".

<Breadcrumb.Root>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='#'>Home</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>→</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='#'>Docs</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>→</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Page>Components</Breadcrumb.Page>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

4. Disabled Breadcrumb

Fully disabled breadcrumb prevents all navigation. Individual link disabling is also supported.

Fully disabled:

Individual link disabled:

<Breadcrumb.Root disabled>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='#'>Home</Breadcrumb.Link>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

<Breadcrumb.Root>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='#' disabled>Home</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Page>Widget</Breadcrumb.Page>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

5. External Links

External links get target="_blank" and rel="noopener noreferrer" for security.

<Breadcrumb.Root>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='https://github.com' isExternal>GitHub</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Page>Issues</Breadcrumb.Page>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

6. Render Props Pattern

BreadcrumbItem provides position,isCurrent, and isDisabled via render props.

<Breadcrumb.Root>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      {({ position }) => <Breadcrumb.Link href='#'>Home [{position}]</Breadcrumb.Link>}
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      {({ position, isCurrent }) =>
        isCurrent ? <Breadcrumb.Page>Current [{position}]</Breadcrumb.Page> : null
      }
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>

7. Polymorphic Root

Root element can be changed with as prop. When not using nav, ensure proper ARIA labeling.

<Breadcrumb.Root as='div' role='navigation' aria-label='File path'>
  <Breadcrumb.List>
    <Breadcrumb.Item>
      <Breadcrumb.Link href='#'>src</Breadcrumb.Link>
    </Breadcrumb.Item>
    <Breadcrumb.Separator>/</Breadcrumb.Separator>
    <Breadcrumb.Item>
      <Breadcrumb.Page>Breadcrumb.tsx</Breadcrumb.Page>
    </Breadcrumb.Item>
  </Breadcrumb.List>
</Breadcrumb.Root>
← All Demos