Pular para o conteúdo

Cartão

Uma caixa com borda para painéis, planos de preços e tabelas de produtos — cabeçalho, conteúdo e rodapé com o efeito de sombra forte no estilo neobrutalista.

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

O card agrupa conteúdo relacionado em uma caixa independente com espaços opcionais de cabeçalho, conteúdo e rodapé. Não há primitivo por baixo — é markup puro estilizado seguindo a receita neobrutalista: uma borda grossa, uma sombra dura deslocada e o título na fonte de títulos.

Use quando:

  • Painéis de dashboard — blocos de estatísticas, gráficos e feeds de atividade organizados em uma grade.
  • Planos de preços — nome e preço do plano no cabeçalho, recursos no corpo, o botão de compra no rodapé.
  • Formulários independentes — caixas de login, cadastro e configurações que precisam de um limite visual.

Instalação

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

Copie e cole o código a seguir no seu projeto.

components/ui/card.tsx
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,
}

Atualize os caminhos de importação para corresponder à estrutura do seu projeto.

Uso

import {
  Card,
  CardAction,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card"
<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>

Composição

Use a seguinte composição para construir um Card:

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

Exemplos

Tamanho

Use a prop size="sm" para reduzir o tamanho do card. A variante reduzida usa um espaçamento mais compacto.

import { ChevronRightIcon } from "lucide-react"

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

Espaçamento

Além da prop size, você pode usar a variável CSS --card-spacing para controlar o espaçamento entre as seções e o recuo interno das partes do card.

"use client"

import * as React from "react"

Use margens negativas com -mx-(--card-spacing) para que o conteúdo se estenda de borda a borda, mantendo-se alinhado com o recuo interno do card. Quando o conteúdo de borda a borda fica acima de um rodapé, use -mb-(--card-spacing) no CardContent para remover o espaço entre seções.

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

Imagem

Adicione uma imagem antes do cabeçalho do card para criar um card com imagem.

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

RTL

Para ativar o suporte a RTL no Neobrutalism, consulte o guia de configuração de RTL.

"use client"

import * as React from "react"

Acessibilidade

O card é puramente visual — cada parte renderiza uma <div> comum sem role implícita, então ele não adiciona nada à árvore de acessibilidade. CardTitle não é um elemento de título: aninhe um <h2><h4> de verdade dentro dele quando o título precisar aparecer na estrutura do documento. Em cards clicáveis, coloque o link ou o botão dentro do card e estenda a área de clique por toda a superfície — nunca anexe onClick à própria <div> do card.

Referência da API

Card

O componente Card é o contêiner raiz do conteúdo do card.

PropTypeDefault
size"default" | "sm""default"
classNamestring-

CardHeader

O componente CardHeader é usado para um título, uma descrição e uma ação opcional.

PropTypeDefault
classNamestring-

CardTitle

O componente CardTitle é usado para o título do card.

PropTypeDefault
classNamestring-

CardDescription

O componente CardDescription é usado para o texto de apoio que aparece abaixo do título.

PropTypeDefault
classNamestring-

CardAction

O componente CardAction posiciona o conteúdo no canto superior direito do cabeçalho (por exemplo, um botão ou um badge).

PropTypeDefault
classNamestring-

CardContent

O componente CardContent é usado para o corpo principal do card.

PropTypeDefault
classNamestring-

CardFooter

O componente CardFooter é usado para as ações e o conteúdo secundário na parte inferior do card.

PropTypeDefault
classNamestring-

Registro de alterações

Variável de espaçamento

Se você estiver atualizando a partir de uma versão anterior do componente Card, precisará aplicar as seguintes alterações para usar a variável --card-spacing:

Atualize as classes de espaçamento da raiz Card.

Substitua o gap e o padding vertical fixados manualmente por --card-spacing, e defina os valores de tamanho padrão e reduzido na raiz:

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

Atualize as classes de espaçamento do CardHeader.

Substitua o padding horizontal e o espaçamento da borda pela variável compartilhada:

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

Atualize as classes de espaçamento de CardContent e CardFooter.

Use --card-spacing para o recuo interno do conteúdo e o padding do rodapé:

  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}
      />
    )
  }
  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
  )}

Após aplicar essas alterações, você pode personalizar o espaçamento do card definindo --card-spacing no Card com uma classe de propriedade arbitrária:

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