Fil d'Ariane

import Link from "next/link"

import {

Le fil d’Ariane situe la page courante dans la hiérarchie du site et fait de chaque niveau supérieur un lien. Ce n’est pas une primitive Base UI — simplement du HTML sémantique (nav + <ol>) qui s’appuie sur le useRender de Base UI pour la composition par prop render — habillé du style néobrutaliste : liens en police de titrage, page courante en gras dans la couleur de premier plan.

À privilégier pour :

• Docs et bases de connaissances — Docs / Composants / Fil d’Ariane ; le lecteur remonte d’un niveau sans fouiller la barre latérale.
• Arborescences de catégories e-commerce — Accueil / Vêtements / Vestes fait sortir d’une fiche produit profonde en un clic.
• Tableaux de bord et explorateurs de fichiers — projets imbriqués, réglages ou chemins de dossiers, là où l’URL seule ne suffit pas à s’orienter.

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
Copier

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

Utilisation#

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

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

Composition#

Utilisez la composition suivante pour construire un Breadcrumb :

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

Exemples#

Simple#

Un fil d’Ariane simple avec un lien vers l’accueil et un lien vers les composants.

import {
  Breadcrumb,
  BreadcrumbItem,

Séparateur personnalisé#

Utilisez un composant personnalisé comme children de <BreadcrumbSeparator /> pour créer un séparateur personnalisé.

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

Menu déroulant#

Vous pouvez composer <BreadcrumbItem /> avec un <DropdownMenu /> pour créer un menu déroulant dans le fil d’Ariane.

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

Réduit#

Nous fournissons un composant <BreadcrumbEllipsis /> pour afficher un état réduit lorsque le fil d’Ariane est trop long.

import Link from "next/link"

import {

Composant de lien#

Pour utiliser un composant de lien personnalisé issu de votre bibliothèque de routage, utilisez la prop render sur <BreadcrumbLink />.

import Link from "next/link"

import {

RTL#

Pour activer le RTL dans Neobrutalism, consultez le guide de configuration RTL.

"use client"

import Link from "next/link"

Accessibilité#

Le fil d’Ariane suit le modèle WAI-ARIA Breadcrumb : Breadcrumb rend un repère <nav aria-label="breadcrumb"> autour d’une liste ordonnée, si bien que les lecteurs d’écran l’annoncent comme une navigation en fil d’Ariane et permettent d’y sauter directement. BreadcrumbPage porte aria-current="page" pour marquer l’emplacement courant, et les séparateurs sont aria-hidden afin de ne pas être lus à voix haute. Les éléments sont de simples liens — comportement standard de Tab et Enter, aucun câblage clavier supplémentaire.

Référence API#

Breadcrumb#

Le composant Breadcrumb est l’élément de navigation racine qui enveloppe tous les composants du fil d’Ariane.

BreadcrumbList#

Le composant BreadcrumbList affiche la liste ordonnée des éléments du fil d’Ariane.

BreadcrumbItem#

Le composant BreadcrumbItem enveloppe chaque élément du fil d’Ariane.

BreadcrumbLink#

Le composant BreadcrumbLink affiche un lien cliquable dans le fil d’Ariane.

BreadcrumbPage#

Le composant BreadcrumbPage affiche la page actuelle dans le fil d’Ariane (non cliquable).

BreadcrumbSeparator#

Le composant BreadcrumbSeparator affiche un séparateur entre les éléments du fil d’Ariane. Vous pouvez passer des enfants personnalisés pour remplacer l’icône de séparateur par défaut.

BreadcrumbEllipsis#

Le composant BreadcrumbEllipsis affiche des points de suspension pour les éléments réduits du fil d’Ariane.