Breadcrumb
Router-aware page trails with native navigation semantics, responsive Menu overflow, projected composition and complete visual ownership.
GET STARTED
Import
Import only the canonical primitives used by the chosen data or projected composition.
Data-driven trail
Immutable items support Angular routes, native URLs, icons, disabled locations and explicit current state.
Semantic selection event
itemSelect reports the stable key, immutable item and original event for visible and overflow selections.
Responsive overflow
maxItems preserves the useful edges and moves the middle into the shared accessible Menu. The dots trigger also uses the shared Tooltip.
Projected items
Declarative source items provide the same normalized model. Use either projected items or [items], never both.
Icon and template separators
Use a Neural Icon class for the common case or a separator template for custom visual language.
Current and disabled states
The final item is current by default unless any item explicitly owns current. Disabled locations stay readable but inert.
Unstyled and typed class slots
Navigation, routing, overflow, Tooltip and structural hooks remain while consumer classes own every visual.
Component boundaries
Breadcrumb
Owns ordered page-trail semantics and routing.
Menu
Owns collapsed middle-item interaction.
Tooltip
Owns overflow-trigger hover and focus help.
ACCESSIBILITY
A page trail, not decorative text
Native nav, ordered list and link semantics remain intact in styled and headless modes.
Named navigation landmark
The root is a native nav containing an ordered list. Localize ariaLabel when the application language is not English.
Current page
Exactly one location should expose aria-current="page". The final item is selected automatically unless an explicit current flag exists.
Native keyboard behavior
Links use browser and Angular Router keyboard semantics. Breadcrumb adds no arrow-key model and never turns readable disabled text into a fake link.
Accessible overflow
The overflow trigger is a native Button named by overflowLabel. The popup delegates focus and keyboard behavior to Neural Menu; Tooltip is supplementary only.
RTL
Flex layout and configured directional icon follow the document direction. Supply a culturally appropriate separator icon when mirroring is important.
PUBLIC API
Breadcrumb contract
Canonical runtime symbols are NeuralBreadcrumb, NeuralBreadcrumbItemComponent and NeuralBreadcrumbSeparatorTemplate.
NeuralBreadcrumbItemComponent inputs
| key | string | required | Stable identity and emitted key. |
| label | string | required | Visible item label. |
| iconClass | string | '' | Optional Neural Icon classes. |
| href | string | '' | Native document URL. |
| routerLink | NeuralBreadcrumbRouterLink | undefined | Angular Router commands. |
| queryParams | Params | null | null | Router query parameters. |
| fragment | string | '' | Router fragment. |
| queryParamsHandling | QueryParamsHandling | null | null | Merge, preserve, or replace query parameters. |
| preserveFragment | boolean | false | Keeps the current fragment when no replacement is supplied. |
| skipLocationChange | boolean | false | Navigates without adding the target URL to browser history. |
| replaceUrl | boolean | false | Replaces the current browser history entry. |
| state | Record<string, unknown> | undefined | undefined | Developer-defined Router history state. |
| target | string | '' | Native link target. |
| rel | string | '' | Native link relationship. |
| disabled | boolean | false | Readable inert state. |
| current | boolean | undefined | undefined | Explicit aria-current override. |
| itemClass | string | '' | Additive item class. |
Typed class slots
rootlistitemlinkcurrentdisablediconlabelseparatoroverflowItemoverflowTriggerPublic types
NeuralBreadcrumbItemImmutable item data for links, state and identity.
NeuralBreadcrumbSelect{ key, item, originalEvent }
NeuralBreadcrumbRouterLinkstring | readonly unknown[] | UrlTree
NeuralBreadcrumbClassesTyped visual ownership slots.
DESIGN TOKENS
Breadcrumb tokens
The stable token contract responds to runtime primary, surface, mode and experimental theme presets.
Container tokens
--neural-breadcrumb-paddingComponent internal spacing.
--neural-breadcrumb-colorComponent foreground color.
--neural-breadcrumb-backgroundComponent background surface.
--neural-breadcrumb-borderComponent border shorthand.
--neural-breadcrumb-radiusComponent corner radius.
--neural-breadcrumb-shadowComponent box shadow.
--neural-breadcrumb-gapSpacing between component items.
--neural-breadcrumb-font-familyComponent font family.
Item and separator tokens
--neural-breadcrumb-item-gapSpacing between item items.
--neural-breadcrumb-item-min-heightItem minimum block size.
--neural-breadcrumb-item-paddingItem internal spacing.
--neural-breadcrumb-item-colorItem foreground color.
--neural-breadcrumb-item-color-activeActive item foreground color.
--neural-breadcrumb-item-background-activeActive item background surface.
--neural-breadcrumb-item-radiusItem corner radius.
--neural-breadcrumb-font-sizeComponent font size.
--neural-breadcrumb-icon-sizeIcon width and height.
--neural-breadcrumb-separator-colorSeparator foreground color.
--neural-breadcrumb-separator-sizeSeparator width and height.
State tokens
--neural-breadcrumb-current-colorCurrent foreground color.
--neural-breadcrumb-current-font-weightCurrent font weight.
--neural-breadcrumb-disabled-opacityDisabled opacity.
--neural-breadcrumb-focus-ringComponent keyboard focus ring.
--neural-breadcrumb-focus-ring-offsetComponent focus ring offset.