跳到内容
1.6k

表格

一款适用于发票、管理列表和价格表的语义化 HTML 表格——带边框的行、加粗的表头，以及强烈的“新粗野主义”风格阴影。

import {
  Table,
  TableBody,

Table 只是给原生 HTML 表格元素——<table>、<thead>、<tbody>、<th>、<td>、<caption>——加上样式，底层没有任何基元库；Radix 与 Base 两个变体提供的是同一份文件。新粗野主义的配方在这里体现为：整张表格外面一圈粗边框加硬阴影、表头单元格使用标题字体，以及 2px 的行分隔线。

适合以下场景：

  • 发票与订单——明细行加上一行 TableFooter 来放总计。
  • 管理后台列表——用户、API 密钥、订阅，再配一个行操作下拉菜单。
  • 定价与对比网格——由列标题承载含义的功能矩阵。

安装

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

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

components/ui/table.tsx
"use client"

import * as React from "react"

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

function Table({ className, ...props }: React.ComponentProps<"table">) {
  return (
    <div
      data-slot="table-container"
      className="relative w-full overflow-x-auto rounded border-2 shadow-md"
    >
      <table
        data-slot="table"
        className={cn("w-full caption-bottom text-sm", className)}
        {...props}
      />
    </div>
  )
}

function TableHeader({ className, ...props }: React.ComponentProps<"thead">) {
  return (
    <thead
      data-slot="table-header"
      className={cn("[&_tr]:border-b-2", className)}
      {...props}
    />
  )
}

function TableBody({ className, ...props }: React.ComponentProps<"tbody">) {
  return (
    <tbody
      data-slot="table-body"
      className={cn("[&_tr:last-child]:border-0", className)}
      {...props}
    />
  )
}

function TableFooter({ className, ...props }: React.ComponentProps<"tfoot">) {
  return (
    <tfoot
      data-slot="table-footer"
      className={cn(
        "border-t-2 bg-muted/50 font-medium [&>tr]:last:border-b-0",
        className
      )}
      {...props}
    />
  )
}

function TableRow({ className, ...props }: React.ComponentProps<"tr">) {
  return (
    <tr
      data-slot="table-row"
      className={cn(
        "border-b-2 transition-colors hover:bg-accent has-aria-expanded:bg-accent data-[state=selected]:bg-accent",
        className
      )}
      {...props}
    />
  )
}

function TableHead({ className, ...props }: React.ComponentProps<"th">) {
  return (
    <th
      data-slot="table-head"
      className={cn(
        "h-10 bg-muted px-2 text-left align-middle font-head font-medium whitespace-nowrap text-foreground [&:has([role=checkbox])]:pr-0",
        className
      )}
      {...props}
    />
  )
}

function TableCell({ className, ...props }: React.ComponentProps<"td">) {
  return (
    <td
      data-slot="table-cell"
      className={cn(
        "p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0",
        className
      )}
      {...props}
    />
  )
}

function TableCaption({
  className,
  ...props
}: React.ComponentProps<"caption">) {
  return (
    <caption
      data-slot="table-caption"
      className={cn("mt-4 text-sm text-muted-foreground", className)}
      {...props}
    />
  )
}

export {
  Table,
  TableHeader,
  TableBody,
  TableFooter,
  TableHead,
  TableRow,
  TableCell,
  TableCaption,
}

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

用法

import {
  Table,
  TableBody,
  TableCaption,
  TableCell,
  TableHead,
  TableHeader,
  TableRow,
} from "@/components/ui/table"
<Table>
  <TableCaption>A list of your recent invoices.</TableCaption>
  <TableHeader>
    <TableRow>
      <TableHead className="w-[100px]">Invoice</TableHead>
      <TableHead>Status</TableHead>
      <TableHead>Method</TableHead>
      <TableHead className="text-right">Amount</TableHead>
    </TableRow>
  </TableHeader>
  <TableBody>
    <TableRow>
      <TableCell className="font-medium">INV001</TableCell>
      <TableCell>Paid</TableCell>
      <TableCell>Credit Card</TableCell>
      <TableCell className="text-right">$250.00</TableCell>
    </TableRow>
  </TableBody>
</Table>

组合

使用以下组合来构建 Table：

Table
├── TableCaption
├── TableHeader
│   └── TableRow
│       ├── TableHead
│       ├── TableHead
│       ├── TableHead
│       └── TableHead
├── TableBody
│   ├── TableRow
│   │   ├── TableCell
│   │   ├── TableCell
│   │   ├── TableCell
│   │   └── TableCell
│   └── TableRow
│       ├── TableCell
│       ├── TableCell
│       ├── TableCell
│       └── TableCell
└── TableFooter

示例

页脚

使用 <TableFooter /> 组件为表格添加页脚。

import {
  Table,
  TableBody,

操作

一个使用 <DropdownMenu /> 组件为每一行显示操作的表格。

import { MoreHorizontalIcon } from "lucide-react"

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

Data Table

您可以使用 <Table /> 组件构建更复杂的数据表格。将其与 @tanstack/react-table 结合使用，即可创建具备排序、筛选和分页功能的表格。

更多信息请参阅 Data Table 文档。

您还可以在 Tasks 演示中查看数据表格的示例。

RTL

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

"use client"

import * as React from "react"

无障碍

直接渲染原生表格元素，屏幕阅读器就能获得表格播报、行列导航和表头关联，完全不用接 ARIA。请用 TableCaption 为每张表格命名，并且只在真正的表头单元格上使用 TableHead。滚动容器本身不可聚焦，因此表格内容溢出时，纯键盘用户没法滚动它——如果预计会出现宽表格，请在您自己那份组件代码里给容器 div 加上 tabIndex={0}、role="region" 和 aria-label。