Skip to content
Back

BreadcrumbPro

Where a page sits: links from the root to the current page, new crumbs sliding in from a blur, and an optional “…” that folds the middle.

oxyn add breadcrumb
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • Shows where a run, file or setting sits (Acme › Atlas › Runs › Run 251) and lets the user jump back up.

When not to use

  • A project header that folds into a compact bar as the page scrolls, with breadcrumb, actions and tabs whose counts roll: use Page header instead.
  • An app sidebar: use Sidebar instead.
  • A workspace sidebar: use Workspace sidebar instead.

Installation

Breadcrumb is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add breadcrumb

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Path

A full path; the last crumb is the current page.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Collapsed

The middle folds behind “…” (Oxyn plus).

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Slash

Slash separators with icons.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

Breadcrumb

PropTypeDefaultDescription
itemsrequiredVec<Crumb>—Path from root to the current page.
labelString"Breadcrumb"Landmark label.
maxusizeDefault::default()Collapse beyond this many crumbs (0 = wrap, never collapse).
separatorString"chevron"`chevron` · `slash`.
on_selectEventHandler<usize>—A crumb without href was pressed (index).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabBetween crumb links
EnterFollow the focused crumb or reveal hidden ones

Accessibility

  • nav landmark with an ordered list.
  • The last item has aria-current=page and is never a link.
  • Separators are aria-hidden.
From the spec

nav landmark (“Breadcrumb”) with an ol; separators aria-hidden; the current page is a span with aria-current=page, never a link.

Motion & interaction

Only the newest crumb animates in (8 px from the left out of a 3 px blur); the rest never move. Hover fills the crumb.

Timing
TransitionDurationEasingReduced motion
Crumb in260 msease.outinstant
Hover fill120 mslinearinstant

Responsive behaviour

  • Wraps onto new lines; crumbs never wrap inside.
  • Use max to collapse long paths on narrow screens.
Edge cases (spec)

Long paths wrap between crumbs, never inside one. A single crumb renders just the current page. Crumbs without href fire on_select(i).

Notes for AI

  • Import Breadcrumb from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: BreadcrumbEl in oxyn_gpui.
  • Props to set first: items.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI