Breadcrumb

A navigation trail. Pass <li> items as children; the chevron separators are drawn by CSS, so no separator markup is needed.

Real use · navigation trail

Using Breadcrumb

Silica ships one design system through three paths. They share a class vocabulary but are not interchangeable — pick the one that matches what you are building.

Plain HTML — CSS classes

The Tailwind v4 plugin. Works in any framework or none — Rails, Django, PHP, Go, a static file. This path is complete for Breadcrumb — it needs no JavaScript, so the classes below are the whole story.

/* in your CSS */
@import "tailwindcss";
@plugin "@wizeworks/silicaui";

Root class breadcrumb, with 0 modifiers:

  • .breadcrumb

React

Typed components over those same classes, with behavior and accessibility from Base UI.

npm i @wizeworks/silicaui-react
import { Breadcrumb } from "@wizeworks/silicaui-react";

Source of the demo above

The exact file that renders the examples above, so it can never drift from them. It imports a few of this site’s own layout helpers (../lib/…), so read it for the component calls rather than copying it whole.

Show source
import { Breadcrumb } from "@wizeworks/silicaui-react";
import { Section } from "../lib/Section";

export function BreadcrumbDemo() {
    return (
        <Section title="Real use · navigation trail">
            <Breadcrumb>
                <li>
                    <a href="#">Home</a>
                </li>
                <li>
                    <a href="#">Projects</a>
                </li>
                <li>
                    <a href="#">Silica UI</a>
                </li>
                <li>
                    <span aria-current="page">Breadcrumb</span>
                </li>
            </Breadcrumb>
        </Section>
    );
}

Vanilla — node tree to HTML

Breadcrumb — a <nav class="breadcrumb"> wrapping an <ol>; each item is a link, the last marked aria-current="page". Items come from props.items (strings). Build a node tree, project it with toHtml(), and let the zero-dependency runtime hydrate it. This is the path for generated or user-authored documents — a site builder, CMS output, a static export.

npm i @wizeworks/silicaui-html @wizeworks/silicaui-behaviors
import { atom, toHtml } from "@wizeworks/silicaui-html";

const node = atom("Breadcrumb", "breadcrumb", { /* props */ });
const markup = toHtml(node);

Styling on this path is the class string in the second argument — the same classes as the Plain HTML section above. There is no color prop here; write "breadcrumb breadcrumb-primary" rather than passing a colour as a prop.

Takes children
no
Hydrated by
nothing — this one is static markup

The full API for Breadcrumb, on every path, is available through the Silica MCP server.