Skip to content

Design system

Documentation

DesignComponents / Breadcrumb

Components / Breadcrumb

Beta

Breadcrumb

Show the current location inside a hierarchy of navigable parent pages.

On this page

Examples

When to use

Use Breadcrumb when a page has a meaningful parent hierarchy. Parent entries are links; the current page is plain text. On narrow screens the navigation can scroll horizontally.

Usage

import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "@phuctech/ui/components/breadcrumb";

<Breadcrumb aria-label="Breadcrumb">
<BreadcrumbList>
  <BreadcrumbItem><BreadcrumbLink href="/projects">Projects</BreadcrumbLink></BreadcrumbItem>
  <BreadcrumbSeparator />
  <BreadcrumbItem><BreadcrumbPage>Atlas</BreadcrumbPage></BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>

API

Component API
PropTypeDefaultDescriptionConstraints
Breadcrumbnav propsaria-label="Breadcrumb"Named navigation landmark with horizontal overflow support.Use one clear label when a page has multiple navigation landmarks.
BreadcrumbListol props—Ordered list of path entries.Keep entries in parent-to-current order.
BreadcrumbItem / BreadcrumbLinkli props / anchor props—A path item and a navigable parent page.Use real href destinations for parent links.
BreadcrumbPagespan propsaria-current="page"The current location, which is not a link.Render one current page per breadcrumb.
BreadcrumbSeparatorli propschevron iconA decorative separator between path items.Decorative by default and hidden from assistive technology.

Tokens

Component tokens
TokenRoleEffective valueUsage
foreground / muted-foregroundCurrent and parent labelsSemantic text colorsKeeps the current location distinct without relying on color alone.
focus-ringParent link focusShared focus styleMakes keyboard focus visible in both themes.

Accessibility

The root is a labeled navigation landmark. The ordered list expresses path order, separators are decorative, and the current page carries aria-current="page". Links use native anchor keyboard behavior.

Do and don’t

Do

Use concise names and real parent destinations.

Don’t

Turn the current page into a link or duplicate the full primary navigation.