Carte

import { Button } from "@/components/ui/button"
import {
  Card,

La carte regroupe des contenus liés dans un bloc autonome, avec des emplacements facultatifs pour l’en-tête, le contenu et le pied. Aucune primitive en dessous — c’est du balisage brut habillé du style néobrutaliste : une bordure épaisse, une ombre décalée marquée et un titre en police de titrage.

À privilégier pour :

• Panneaux de tableau de bord — tuiles de statistiques, graphiques et flux d’activité disposés en grille.
• Paliers tarifaires — nom du forfait et prix dans l’en-tête, fonctionnalités dans le corps, bouton d’achat dans le pied.
• Formulaires autonomes — blocs de connexion, d’inscription et de réglages qui ont besoin d’une frontière visuelle.

Installation#

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

import * as React from "react"

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

function Card({
  className,
  size = "default",
  ...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
  return (
    <div
      data-slot="card"
      data-size={size}
      className={cn(
        "group/card flex flex-col gap-(--card-spacing) overflow-hidden rounded border-2 bg-card py-(--card-spacing) text-sm text-card-foreground shadow-md [--card-spacing:--spacing(4)] has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:[--card-spacing:--spacing(3)] data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
        className
      )}
      {...props}
    />
  )
}

function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-header"
      className={cn(
        "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-(--card-spacing) has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-(--card-spacing)",
        className
      )}
      {...props}
    />
  )
}

function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-title"
      className={cn(
        "cn-font-heading text-base leading-snug font-medium group-data-[size=sm]/card:text-sm",
        className
      )}
      {...props}
    />
  )
}

function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-description"
      className={cn("text-sm text-muted-foreground", className)}
      {...props}
    />
  )
}

function CardAction({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-action"
      className={cn(
        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
        className
      )}
      {...props}
    />
  )
}

function CardContent({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-content"
      className={cn("px-(--card-spacing)", className)}
      {...props}
    />
  )
}

function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-footer"
      className={cn(
        "flex items-center rounded-b-xl border-t-2 bg-muted/50 p-(--card-spacing)",
        className
      )}
      {...props}
    />
  )
}

export {
  Card,
  CardHeader,
  CardFooter,
  CardTitle,
  CardAction,
  CardDescription,
  CardContent,
}

Utilisation#

Copierimport {
  Card,
  CardAction,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card"

Copier<Card>
  <CardHeader>
    <CardTitle>Card Title</CardTitle>
    <CardDescription>Card Description</CardDescription>
    <CardAction>Card Action</CardAction>
  </CardHeader>
  <CardContent>
    <p>Card Content</p>
  </CardContent>
  <CardFooter>
    <p>Card Footer</p>
  </CardFooter>
</Card>

Composition#

Utilisez la composition suivante pour construire une Card :

CopierCard
├── CardHeader
│   ├── CardTitle
│   ├── CardDescription
│   └── CardAction
├── CardContent
└── CardFooter

Exemples#

Taille#

Utilisez la prop size="sm" pour réduire la taille de la carte. La variante réduite utilise des espacements plus resserrés.

import { ChevronRightIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

Espacement#

En plus de la prop size, vous pouvez utiliser la variable CSS --card-spacing pour régler l’espacement entre les sections et la marge interne des différentes parties de la carte.

"use client"

import * as React from "react"

Utilisez des marges négatives avec -mx-(--card-spacing) pour que le contenu s’étende d’un bord à l’autre tout en restant aligné sur la marge interne de la carte. Lorsque ce contenu pleine largeur précède un pied de page, appliquez -mb-(--card-spacing) sur CardContent pour supprimer l’écart entre les sections.

import { Button } from "@/components/ui/button"
import {
  Card,

Image#

Ajoutez une image avant l’en-tête de la carte pour créer une carte illustrée.

import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import {

RTL#

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

"use client"

import * as React from "react"

Accessibilité#

La carte est purement présentationnelle — chaque partie rend une simple <div> sans rôle implicite, elle n’ajoute donc rien à l’arbre d’accessibilité. CardTitle n’est pas un élément de titre : imbriquez-y un vrai <h2>–<h4> quand le titre doit apparaître dans le plan du document. Pour les cartes cliquables, placez le lien ou le bouton à l’intérieur de la carte et étendez sa zone de clic à toute la surface — n’attachez jamais onClick à la <div> de la carte elle-même.

Référence API#

Card#

Le composant Card est le conteneur racine du contenu de la carte.

CardHeader#

Le composant CardHeader accueille un titre, une description et une action facultative.

CardTitle#

Le composant CardTitle correspond au titre de la carte.

CardDescription#

Le composant CardDescription sert au texte d’aide affiché sous le titre.

CardAction#

Le composant CardAction place du contenu en haut à droite de l’en-tête (par exemple un bouton ou un badge).

CardContent#

Le composant CardContent correspond au corps principal de la carte.

CardFooter#

Le composant CardFooter accueille les actions et le contenu secondaire au bas de la carte.

Journal des modifications#

Variable d’espacement#

Si vous migrez depuis une version précédente du composant Card, appliquez les modifications suivantes pour utiliser la variable --card-spacing :

Copier  className={cn(
-   "group/card flex flex-col gap-4 overflow-hidden rounded-xl bg-card py-4 text-sm text-card-foreground ring-1 ring-foreground/10 has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
+   "group/card flex flex-col gap-(--card-spacing) overflow-hidden rounded-xl bg-card py-(--card-spacing) text-sm text-card-foreground ring-1 ring-foreground/10 [--card-spacing:--spacing(4)] has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:[--card-spacing:--spacing(3)] data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
    className
  )}

Copier  className={cn(
-   "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-4 group-data-[size=sm]/card:px-3 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-4 group-data-[size=sm]/card:[.border-b]:pb-3",
+   "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-(--card-spacing) has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-(--card-spacing)",
    className
  )}

Copier  function CardContent({ className, ...props }: React.ComponentProps<"div">) {
    return (
      <div
        data-slot="card-content"
-       className={cn("px-4 group-data-[size=sm]/card:px-3", className)}
+       className={cn("px-(--card-spacing)", className)}
        {...props}
      />
    )
  }

Copier  className={cn(
-   "flex items-center rounded-b-xl border-t bg-muted/50 p-4 group-data-[size=sm]/card:p-3",
+   "flex items-center rounded-b-xl border-t bg-muted/50 p-(--card-spacing)",
    className
  )}

Une fois ces modifications appliquées, vous pouvez personnaliser l’espacement de la carte en définissant --card-spacing sur la Card à l’aide d’une classe de propriété arbitraire :

Copierfunction Example() {
  return <Card className="[--card-spacing:--spacing(6)]">...</Card>
}