Kruimelpad

import Link from "next/link"

import {

De breadcrumb toont de positie van de huidige pagina in de hiërarchie van de site en linkt elk niveau erboven. Het is geen Base UI-primitive — gewoon semantische HTML (nav + <ol>) die useRender van Base UI gebruikt voor compositie via de prop render — vormgegeven volgens het neobrutalistische recept: links in het koplettertype, de huidige pagina in vette voorgrondtekst.

Gebruik deze component bij:

• Docs en kennisbanken — Docs / Componenten / Breadcrumb; lezers stappen een niveau terug zonder de zijbalk af te hoeven zoeken.
• Categoriebomen in webshops — met Home / Kleding / Jassen ontsnap je in één klik uit een diep gelegen productpagina.
• Dashboards en bestandsbrowsers — geneste projecten, instellingen of mappaden waar de URL alleen te weinig houvast geeft.

Installatie#

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
Kopiëren

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,
}

Gebruik#

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

Kopiëren<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>

Compositie#

Gebruik de volgende compositie om een Breadcrumb te bouwen:

KopiërenBreadcrumb
└── BreadcrumbList
    ├── BreadcrumbItem
    │   └── BreadcrumbLink
    ├── BreadcrumbSeparator
    ├── BreadcrumbItem
    │   └── BreadcrumbLink
    ├── BreadcrumbSeparator
    └── BreadcrumbItem
        └── BreadcrumbPage

Voorbeelden#

Basis#

Een eenvoudige breadcrumb met een home-link en een components-link.

import {
  Breadcrumb,
  BreadcrumbItem,

Aangepaste scheiding#

Gebruik een aangepaste component als children voor <BreadcrumbSeparator /> om een aangepaste scheiding te maken.

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

Dropdown#

Je kunt <BreadcrumbItem /> combineren met een <DropdownMenu /> om een dropdown in de breadcrumb te maken.

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

Ingeklapt#

We bieden een <BreadcrumbEllipsis />-component om een ingeklapte staat te tonen wanneer de breadcrumb te lang is.

import Link from "next/link"

import {

Link-component#

Om een aangepaste link-component uit je routing-bibliotheek te gebruiken, kun je de prop render op <BreadcrumbLink /> gebruiken.

import Link from "next/link"

import {

RTL#

Om RTL-ondersteuning in Neobrutalism in te schakelen, zie de RTL-configuratiegids.

"use client"

import Link from "next/link"

Toegankelijkheid#

De breadcrumb volgt het WAI-ARIA Breadcrumb-patroon: Breadcrumb rendert een <nav aria-label="breadcrumb">-landmark om een geordende lijst heen, zodat schermlezers hem als kruimelpadnavigatie aankondigen en gebruikers er rechtstreeks naartoe kunnen springen. BreadcrumbPage draagt aria-current="page" om de huidige locatie te markeren, en de scheidingstekens zijn aria-hidden, zodat ze niet worden voorgelezen. De items zijn gewone links — standaard Tab- en Enter-gedrag, zonder extra toetsenbordlogica.

API-referentie#

Breadcrumb#

De component Breadcrumb is het wortel-navigatie-element dat alle breadcrumb-componenten omhult.

BreadcrumbList#

De component BreadcrumbList toont de geordende lijst met breadcrumb-items.

BreadcrumbItem#

De component BreadcrumbItem omhult afzonderlijke breadcrumb-items.

BreadcrumbLink#

De component BreadcrumbLink toont een klikbare link in de breadcrumb.

BreadcrumbPage#

De component BreadcrumbPage toont de huidige pagina in de breadcrumb (niet klikbaar).

BreadcrumbSeparator#

De component BreadcrumbSeparator toont een scheiding tussen breadcrumb-items. Je kunt aangepaste children doorgeven om het standaard scheidingspictogram te overschrijven.

BreadcrumbEllipsis#

De component BreadcrumbEllipsis toont een weglatingsteken-indicator voor ingeklapte breadcrumb-items.