Brotkrumen

import Link from "next/link"

import {

Die Breadcrumb zeigt die Position der aktuellen Seite in der Seitenhierarchie und verlinkt jede Ebene darüber. Sie ist kein Base-UI-Primitive – nur semantisches HTML (nav + <ol>), das für die Komposition per render-Prop useRender von Base UI nutzt – gestaltet nach dem neobrutalistischen Rezept: Links in der Überschriftenschrift, die aktuelle Seite fett in der Vordergrundfarbe.

Die richtige Wahl für:

• Doku und Wissensdatenbanken – Doku / Komponenten / Breadcrumb; Lesende gehen eine Ebene zurück, ohne die Sidebar zu durchforsten.
• E-Commerce-Kategoriebäume – Start / Kleidung / Jacken führt mit einem Klick aus einer tiefen Produktseite heraus.
• Dashboards und Dateibrowser – verschachtelte Projekte, Einstellungen oder Ordnerpfade, bei denen die URL allein nicht zur Orientierung reicht.

Installation#

pnpmnpmyarnbun
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/breadcrumb.json
npx shadcn@latest add https://neobrutalism.com/r/base/breadcrumb.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/breadcrumb.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/breadcrumb.json
Kopieren

import * as React from "react"
import { ChevronRightIcon, MoreHorizontalIcon } from "lucide-react"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

function Breadcrumb({ className, ...props }: React.ComponentProps<"nav">) {
  return (
    <nav
      aria-label="breadcrumb"
      data-slot="breadcrumb"
      className={cn(className)}
      {...props}
    />
  )
}

function BreadcrumbList({ className, ...props }: React.ComponentProps<"ol">) {
  return (
    <ol
      data-slot="breadcrumb-list"
      className={cn(
        "flex flex-wrap items-center gap-1.5 text-sm wrap-break-word text-muted-foreground",
        className
      )}
      {...props}
    />
  )
}

function BreadcrumbItem({ className, ...props }: React.ComponentProps<"li">) {
  return (
    <li
      data-slot="breadcrumb-item"
      className={cn("inline-flex items-center gap-1", className)}
      {...props}
    />
  )
}

function BreadcrumbLink({
  asChild,
  className,
  ...props
}: React.ComponentProps<"a"> & {
  asChild?: boolean
}) {
  const Comp = asChild ? Slot.Root : "a"

  return (
    <Comp
      data-slot="breadcrumb-link"
      className={cn("font-head transition-colors hover:text-foreground", className)}
      {...props}
    />
  )
}

function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">) {
  return (
    <span
      data-slot="breadcrumb-page"
      role="link"
      aria-disabled="true"
      aria-current="page"
      className={cn("font-medium text-foreground", className)}
      {...props}
    />
  )
}

function BreadcrumbSeparator({
  children,
  className,
  ...props
}: React.ComponentProps<"li">) {
  return (
    <li
      data-slot="breadcrumb-separator"
      role="presentation"
      aria-hidden="true"
      className={cn("[&>svg]:size-3.5", className)}
      {...props}
    >
      {children ?? <ChevronRightIcon className="cn-rtl-flip" />}
    </li>
  )
}

function BreadcrumbEllipsis({
  className,
  ...props
}: React.ComponentProps<"span">) {
  return (
    <span
      data-slot="breadcrumb-ellipsis"
      role="presentation"
      aria-hidden="true"
      className={cn(
        "flex size-5 items-center justify-center [&>svg]:size-4",
        className
      )}
      {...props}
    >
      <MoreHorizontalIcon />
      <span className="sr-only">More</span>
    </span>
  )
}

export {
  Breadcrumb,
  BreadcrumbList,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbPage,
  BreadcrumbSeparator,
  BreadcrumbEllipsis,
}

Verwendung#

Kopierenimport {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"

Kopieren<Breadcrumb>
  <BreadcrumbList>
    <BreadcrumbItem>
      <BreadcrumbLink render={<a href="/" />}>Home</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbLink render={<a href="/components" />}>
        Components
      </BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
    </BreadcrumbItem>
  </BreadcrumbList>
</Breadcrumb>

Komposition#

Verwende die folgende Komposition, um ein Breadcrumb aufzubauen:

KopierenBreadcrumb
└── BreadcrumbList
    ├── BreadcrumbItem
    │   └── BreadcrumbLink
    ├── BreadcrumbSeparator
    ├── BreadcrumbItem
    │   └── BreadcrumbLink
    ├── BreadcrumbSeparator
    └── BreadcrumbItem
        └── BreadcrumbPage

Beispiele#

Basis#

Ein einfaches Breadcrumb mit einem Home-Link und einem Components-Link.

import {
  Breadcrumb,
  BreadcrumbItem,

Benutzerdefinierter Separator#

Verwende eine benutzerdefinierte Komponente als children für <BreadcrumbSeparator />, um einen benutzerdefinierten Separator zu erstellen.

import Link from "next/link"
import { DotIcon } from "lucide-react"

Dropdown#

Du kannst <BreadcrumbItem /> mit einem <DropdownMenu /> kombinieren, um ein Dropdown im Breadcrumb zu erstellen.

import Link from "next/link"
import { ChevronDownIcon, DotIcon } from "lucide-react"

Reduziert#

Wir stellen eine <BreadcrumbEllipsis />-Komponente bereit, um einen reduzierten Zustand anzuzeigen, wenn das Breadcrumb zu lang ist.

import Link from "next/link"

import {

Link-Komponente#

Um eine benutzerdefinierte Link-Komponente aus deiner Routing-Bibliothek zu verwenden, kannst du die Prop render an <BreadcrumbLink /> verwenden.

import Link from "next/link"

import {

RTL#

Um die RTL-Unterstützung in Neobrutalism zu aktivieren, siehe die RTL-Konfigurationsanleitung.

"use client"

import Link from "next/link"

Barrierefreiheit#

Die Breadcrumb folgt dem WAI-ARIA-Breadcrumb-Pattern: Breadcrumb rendert eine <nav aria-label="breadcrumb">-Landmarke um eine geordnete Liste, sodass Screenreader sie als Breadcrumb-Navigation ankündigen und Nutzende direkt zu ihr springen können. BreadcrumbPage trägt aria-current="page" zur Markierung der aktuellen Position, und die Trenner sind aria-hidden, damit sie nicht vorgelesen werden. Die Einträge sind gewöhnliche Links – Standardverhalten mit Tab und Enter, keine zusätzliche Tastaturverdrahtung nötig.

API-Referenz#

Breadcrumb#

Die Breadcrumb-Komponente ist das Wurzel-Navigationselement, das alle Breadcrumb-Komponenten umschließt.

BreadcrumbList#

Die BreadcrumbList-Komponente zeigt die geordnete Liste der Breadcrumb-Elemente.

BreadcrumbItem#

Die BreadcrumbItem-Komponente umschließt einzelne Breadcrumb-Elemente.

BreadcrumbLink#

Die BreadcrumbLink-Komponente zeigt einen klickbaren Link im Breadcrumb.

BreadcrumbPage#

Die BreadcrumbPage-Komponente zeigt die aktuelle Seite im Breadcrumb (nicht klickbar).

BreadcrumbSeparator#

Die BreadcrumbSeparator-Komponente zeigt einen Separator zwischen Breadcrumb-Elementen. Du kannst benutzerdefinierte children übergeben, um das Standard-Separator-Icon zu überschreiben.

BreadcrumbEllipsis#

Die BreadcrumbEllipsis-Komponente zeigt einen Auslassungspunkte-Indikator für reduzierte Breadcrumb-Elemente.