Navigation

Breadcrumbs

One typed list in, correct landmark, ordered-list and current-page semantics out.

Choose it deliberately

Use the component when its contract matches the user task.

01

Use when

The user needs to see and climb the position of a page inside a real hierarchy.

02

Avoid overloading

It is not a step indicator, a tab bar, or a history of visited pages.

Composition

Sizing, labels, and neighboring elements should preserve visual hierarchy.

01

One primary meaning

Titles stay short: the trail supports the page heading, it does not replace it.

02

Stable keys

Provide id or to per item so reordering never reuses the wrong key.