Breadcrumb shows the current location in a hierarchy and helps users navigate back through parent levels.
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".
<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>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>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>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>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>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>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>