Navigation
Breadcrumb
Shows the path to the current resource using native links.
Usage
Anatomy
The parts and how they nest, taken from the preview above.
Examples
Workspace resources
With icons
Compose decorative icons with ancestor links and the current page.
Collapsed ancestors
An accessible menu reveals omitted links.
Custom separator
Supply slash separators through children.
Long labels
Resource identifiers wrap within narrow containers.
Recommendations
| Guidance | Practice |
|---|---|
| Do | Show meaningful ancestors and name the current resource. Use real destinations for ancestor links. |
| Do | Place decorative icons beside text as children. Give icon-only links and collapsed Menu triggers an accessible name. |
Usage boundaries
| Guidance | Boundary |
|---|---|
| Scope | Breadcrumbs describe hierarchy, not browser history. Do not make the current page a redundant navigation action. |
API reference
Public props from @mizen-labs/ui. Use exported prop types for the complete TypeScript contract.
| Prop | Type | Default | Description |
|---|---|---|---|
| | aria-label="breadcrumb" | Native navigation props, refs, and styling. |
| | — | Native ordered list props with wrapping and quiet typography. |
| | — | Native list-item props and inline icon alignment. |
| | — | Native anchor props, styling, refs, and render composition for framework links. |
| | aria-current="page" | Native span props for the current location, including icon children. |
| | Chevron | Native list-item props. Custom children replace the hidden separator icon. |
| | Dots | Decorative indicator. Name the enclosing menu trigger when revealing omitted ancestors. |