navigation — wyrd.component.breadcrumbs

Breadcrumbs

Navigation trail where the final item identifies the current page.

Install @wyrd-company/react or the Flutter package and use it directly — your DESIGN.md does the styling.

01

Examples

Generated from the contract's examples block. Previews are the published @wyrd-company/react component, themed by the brand's role tokens — flip the site's light/dark toggle and they follow.

Code target Applies to every example on component pages.
product-navigation state: default
Usage
import { WyrdBreadcrumbs } from "@wyrd-company/react";

<WyrdBreadcrumbs items={[{"label":"Home","href":"/"},{"label":"Documentation","href":"/docs"},{"label":"Component catalog","href":"/docs/components"}]} />

// events: onItemPress
deep-navigation state: default
Usage
import { WyrdBreadcrumbs } from "@wyrd-company/react";

<WyrdBreadcrumbs items={[{"label":"Home","href":"/"},{"label":"Documentation","href":"/docs"},{"label":"Component catalog","href":"/docs/components"},{"label":"Navigation components","href":"/docs/components/navigation"},{"label":"Breadcrumbs and hierarchical wayfinding","href":"/docs/breadcrumbs"}]} />

// events: onItemPress
02

Properties

NameTypeDefaultSummary
items array undefined Ordered breadcrumb items; the last item is the current page.
03

Slots & events

EventPayloadSummary
item-press href Emitted when a non-current breadcrumb link is activated.
04

Tokens

The contract's token bindings. Open the shared contextual sidebar from any example; primary swatches reflect the color you pick there. Error swatches show the active preset's values; editing any knob switches to custom and resets error to TWW · Ink.

BindingToken
link.color color.primary
current.color color.on-surface
separator.color color.on-surface-variant
gap spacing.xs
text typography.label-md
05

States

StateSourceSummary
default platform Trail with link ancestors and plain-text current page.
06

Accessibility

From the contract's accessibility obligations. Role navigation; Component-owned localized navigation message labels the landmark.

  • Tab moves through non-current breadcrumb links in document order.
  • Enter activates a focused breadcrumb link.
  • Web renders a nav with localized aria-label wrapping an ordered list.
  • The last item is plain text with aria-current=page.
  • Separators are generated as hidden presentation only and are not exposed to accessibility APIs.
  • Flutter exposes a labeled Semantics container with link children and selected current-page text.
  • Verified under: rtl, cvd-deuteranopia, density-compact, text-expansion.
07

SDUI

Status: serializable. Breadcrumbs serialize item labels and hrefs; hosts own navigation after item-press in non-web targets.

SerializableMembers
Propertiesitems
Slots
Eventsitem-press
The Wyrding Way — a contract-first design system. © Wyrd Company