跳到内容
1.6k

卡片

用于仪表盘、定价层级和产品网格的带边框框体——标题、内容和页脚均采用了新粗野主义风格的硬阴影处理。

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

卡片把相关内容收进一个自成一体的盒子里，头部、内容和底部这几个插槽都是可选的。底层没有基元——它就是按新粗野主义的配方设计的普通标记：一圈粗边框、一道硬偏移阴影，以及标题字体的标题。

适合以下场景：

  • 仪表盘面板——排成网格的数据块、图表和动态流。
  • 价格档位——头部放套餐名和价格，主体放功能列表，底部放购买按钮。
  • 独立表单——需要一圈视觉边界的登录、注册和设置框。

安装

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

将以下代码复制并粘贴到您的项目中。

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

更新导入路径以匹配您的项目设置。

用法

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>

组合

使用以下组合来构建 Card：

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

示例

尺寸

使用 size="sm" 属性将卡片的尺寸设置为小号。小尺寸变体使用更小的间距。

import { ChevronRightIcon } from "lucide-react"

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

间距

除了 size 属性外，您还可以使用 --card-spacing CSS 变量来控制各区块之间的间距以及卡片各部分的内边距。

"use client"

import * as React from "react"

使用 -mx-(--card-spacing) 的负外边距可以让内容延伸到边缘，同时保持与卡片内边距对齐。当延伸到边缘的内容位于页脚上方时，可在 CardContent 上使用 -mb-(--card-spacing) 来移除区块间隙。

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

图片

在卡片头部之前添加一张图片，即可创建带图片的卡片。

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

RTL

要在 Neobrutalism 中启用 RTL 支持，请参阅 RTL 配置指南。

"use client"

import * as React from "react"

无障碍

卡片纯粹用于呈现——每个部分渲染的都是没有隐式 role 的普通 <div>，不会给无障碍树添加任何东西。CardTitle 并不是标题元素：如果这个标题应当出现在文档大纲里，请在它内部嵌一个真正的 <h2>–<h4>。要做可点击的卡片，请把链接或按钮放进卡片里，再让它的点击区域铺满整个表面——千万不要把 onClick 挂到卡片的 <div> 上。

API 参考

Card

Card 组件是卡片内容的根容器。

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

CardHeader

CardHeader 组件用于标题、描述和可选的操作。

PropTypeDefault
classNamestring-

CardTitle

CardTitle 组件用于卡片标题。

PropTypeDefault
classNamestring-

CardDescription

CardDescription 组件用于标题下方的辅助文本。

PropTypeDefault
classNamestring-

CardAction

CardAction 组件将内容放置在头部的右上角（例如按钮或徽章）。

PropTypeDefault
classNamestring-

CardContent

CardContent 组件用于卡片的主体内容。

PropTypeDefault
classNamestring-

CardFooter

CardFooter 组件用于卡片底部的操作和次要内容。

PropTypeDefault
classNamestring-

更新日志

间距变量

如果您正从旧版本的 Card 组件升级，则需要应用以下更新以使用 --card-spacing 变量：

更新 Card 根元素的间距类。

用 --card-spacing 替换硬编码的 gap 和纵向内边距，并在根元素上设置默认尺寸和小尺寸的值：

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

更新 CardHeader 的间距类。

用共享变量替换横向内边距和边框间距：

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

更新 CardContent 和 CardFooter 的间距类。

为内容内边距和页脚内边距使用 --card-spacing：

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

应用这些更改后，您可以通过任意属性类在 Card 上设置 --card-spacing 来自定义卡片的间距：

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