Migas de pan

import Link from "next/link"

import {

La ruta de navegación muestra la posición de la página actual dentro de la jerarquía del sitio y enlaza cada nivel superior. No es una primitiva de Base UI: es solo HTML semántico (nav + <ol>) que usa useRender de Base UI para la composición con la prop render, con la receta neobrutalista: enlaces en la tipografía de encabezados y la página actual en negrita con el color principal del texto.

Úsalo cuando:

• Documentación y bases de conocimiento — Docs / Componentes / Breadcrumb; el lector retrocede un nivel sin rebuscar en la barra lateral.
• Árboles de categorías en comercio electrónico — Inicio / Ropa / Chaquetas sale de una página de producto profunda con un solo clic.
• Paneles y exploradores de archivos — proyectos anidados, ajustes o rutas de carpetas donde la URL por sí sola no orienta.

Instalación#

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
Copiar

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

Uso#

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

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

Composición#

Usa la siguiente composición para construir un Breadcrumb:

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

Ejemplos#

Básico#

Una ruta de navegación básica con un enlace de inicio y un enlace a los componentes.

import {
  Breadcrumb,
  BreadcrumbItem,

Separador personalizado#

Usa un componente personalizado como children de <BreadcrumbSeparator /> para crear un separador personalizado.

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

Menú desplegable#

Puedes componer <BreadcrumbItem /> con un <DropdownMenu /> para crear un menú desplegable en la ruta de navegación.

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

Reducido#

Ofrecemos un componente <BreadcrumbEllipsis /> para mostrar un estado reducido cuando la ruta de navegación es demasiado larga.

import Link from "next/link"

import {

Componente de enlace#

Para usar un componente de enlace personalizado de tu biblioteca de rutas, utiliza la prop render en <BreadcrumbLink />.

import Link from "next/link"

import {

RTL#

Para activar la compatibilidad con RTL en Neobrutalism, consulta la guía de configuración de RTL.

"use client"

import Link from "next/link"

Accesibilidad#

La ruta de navegación sigue el patrón Breadcrumb de WAI-ARIA: Breadcrumb renderiza un landmark <nav aria-label="breadcrumb"> que envuelve una lista ordenada, de modo que los lectores de pantalla la anuncian como ruta de navegación y el usuario puede saltar directamente a ella. BreadcrumbPage lleva aria-current="page" para marcar la ubicación actual, y los separadores son aria-hidden para que no se lean en voz alta. Los elementos son enlaces normales: comportamiento estándar de Tab y Enter, sin cableado de teclado adicional.

Referencia de API#

Breadcrumb#

El componente Breadcrumb es el elemento de navegación raíz que envuelve todos los componentes de la ruta de navegación.

BreadcrumbList#

El componente BreadcrumbList muestra la lista ordenada de elementos de la ruta de navegación.

BreadcrumbItem#

El componente BreadcrumbItem envuelve cada elemento de la ruta de navegación.

BreadcrumbLink#

El componente BreadcrumbLink muestra un enlace en el que se puede hacer clic dentro de la ruta de navegación.

BreadcrumbPage#

El componente BreadcrumbPage muestra la página actual dentro de la ruta de navegación (sin posibilidad de clic).

BreadcrumbSeparator#

El componente BreadcrumbSeparator muestra un separador entre los elementos de la ruta de navegación. Puedes pasar children personalizados para sustituir el icono de separador por defecto.

BreadcrumbEllipsis#

El componente BreadcrumbEllipsis muestra unos puntos suspensivos para los elementos reducidos de la ruta de navegación.