פירורי לחם

מציג את מיקום הדף בהיררכיה של האתר — מסלולי קישורים למסמכים, קטגוריות חנות ולוחות מחוונים — בגופן נואוברוטליסטי מודגש.

import Link from "next/link"

import {

ה-breadcrumb מציג את מיקום העמוד הנוכחי בהיררכיית האתר ומקשר לכל הרמות שמעליו. זה לא פרימיטיב של Base UI — רק HTML סמנטי (nav + <ol>) שמשתמש ב-useRender של Base UI להרכבה עם prop ה-render — מעוצב לפי המתכון הנאו-ברוטליסטי: קישורים בגופן כותרות, העמוד הנוכחי בטיפוגרפיית foreground מודגשת.

השתמשו בו כש:

תיעוד ובסיסי ידע — Docs / Components / Breadcrumb; הקוראים חוזרים רמה בלי לחפש בסרגל הצד.
עצי קטגוריות במסחר — Home / Clothing / Jackets יוצאים מעמוד מוצר עמוק בלחיצה אחת.
לוחות מחוונים ודפדפני קבצים — פרויקטים מקוננים, הגדרות או נתיבי תיקיות כשה-URL לבדו לא מכוון.

התקנה


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

העתיקו והדביקו את הקוד הבא לתוך הפרויקט שלכם.

components/ui/breadcrumb.tsx

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

עדכנו את נתיבי הייבוא כך שיתאימו למבנה הפרויקט שלכם.

שימוש

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

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

קומפוזיציה

השתמשו בקומפוזיציה הבאה כדי לבנות Breadcrumb:

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

דוגמאות

בסיסי

פירורי לחם בסיסיים עם קישור לדף הבית וקישור לרכיבים.

import {
  Breadcrumb,
  BreadcrumbItem,

מפריד מותאם אישית

השתמשו ברכיב מותאם אישית בתור children של <BreadcrumbSeparator /> כדי ליצור מפריד מותאם אישית.

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

תפריט נפתח

תוכלו להרכיב <BreadcrumbItem /> יחד עם <DropdownMenu /> כדי ליצור תפריט נפתח בתוך פירורי הלחם.

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

מכווץ

אנחנו מספקים רכיב <BreadcrumbEllipsis /> להצגת מצב מכווץ כאשר פירורי הלחם ארוכים מדי.

import Link from "next/link"

import {

רכיב קישור

כדי להשתמש ברכיב קישור מותאם אישית מספריית הניתוב שלכם, תוכלו להשתמש במאפיין render על <BreadcrumbLink />.

import Link from "next/link"

import {

RTL

כדי להפעיל RTL ב-Neobrutalism, עיינו במדריך ההגדרה של RTL.

"use client"

import Link from "next/link"

נגישות

ה-breadcrumb עוקב אחרי דפוס Breadcrumb של WAI-ARIA: Breadcrumb מרנדר landmark <nav aria-label="breadcrumb"> שעוטף רשימה ממוספרת, כך שקוראי מסך מכריזים עליו כניווט breadcrumb ומשתמשים יכולים לקפוץ אליו ישר. BreadcrumbPage נושא aria-current="page" לסימון המיקום הנוכחי, ומפרידים הם aria-hidden כדי שלא ייקראו בקול. הפריטים הם קישורים רגילים — התנהגות Tab ו-Enter סטנדרטית, בלי חיווט מקלדת נוסף.

תיעוד ה-API

רכיב Breadcrumb הוא אלמנט הניווט השורשי שעוטף את כל רכיבי פירורי הלחם.

Prop	Type	Default
`className`	`string`	-

BreadcrumbList

רכיב BreadcrumbList מציג את הרשימה הסדורה של פריטי פירורי הלחם.

Prop	Type	Default
`className`	`string`	-

BreadcrumbItem

רכיב BreadcrumbItem עוטף פריטי פירורי לחם בודדים.

Prop	Type	Default
`className`	`string`	-

BreadcrumbLink

רכיב BreadcrumbLink מציג קישור לחיץ בתוך פירורי הלחם.

Prop	Type	Default
`className`	`string`	-

BreadcrumbPage

רכיב BreadcrumbPage מציג את הדף הנוכחי בתוך פירורי הלחם (לא לחיץ).

Prop	Type	Default
`className`	`string`	-

BreadcrumbSeparator

רכיב BreadcrumbSeparator מציג מפריד בין פריטי פירורי הלחם. תוכלו להעביר children מותאמים אישית כדי לעקוף את סמל המפריד המוגדר כברירת מחדל.

Prop	Type	Default
`children`	`React.ReactNode`	-
`className`	`string`	-

BreadcrumbEllipsis

רכיב BreadcrumbEllipsis מציג מחוון של שלוש נקודות עבור פריטי פירורי לחם מכווצים.

Prop	Type	Default
`className`	`string`	-