Przejdź do treści
1.6k

Tabela

Semantyczna tabela HTML do faktur, list administracyjnych i tabel cenowych — wiersze z obramowaniem, pogrubione nagłówki i mocny cień w stylu neobrutalistycznym.

import {
  Table,
  TableBody,

Table styluje natywne elementy tabeli HTML — <table>, <thead>, <tbody>, <th>, <td>, <caption> — bez żadnej biblioteki prymitywów pod spodem; warianty Radix i Base dostarczają ten sam plik. Neobrutalistyczna receptura: gruba ramka i twardy cień wokół całej tabeli, komórki nagłówka złożone fontem nagłówkowym i linie między wierszami o grubości 2px.

Sięgnij po to rozwiązanie, gdy:

  • Faktury i zamówienia — pozycje dokumentu z wierszem TableFooter na sumę.
  • Listy w panelach administracyjnych — użytkownicy, klucze API, subskrypcje, z rozwijanym menu akcji dla wiersza.
  • Cenniki i tabele porównawcze — macierze funkcji, w których znaczenie niosą nagłówki kolumn.

Instalacja

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

Skopiuj i wklej poniższy kod do swojego projektu.

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

Zaktualizuj ścieżki importu, aby pasowały do konfiguracji Twojego projektu.

Użycie

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>

Kompozycja

Użyj poniższej kompozycji, aby zbudować Table:

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

Przykłady

Stopka tabeli

Użyj komponentu <TableFooter />, aby dodać stopkę do tabeli.

import {
  Table,
  TableBody,

Akcje

Tabela pokazująca akcje dla każdego wiersza przy użyciu komponentu <DropdownMenu />.

import { MoreHorizontalIcon } from "lucide-react"

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

Data Table

Możesz użyć komponentu <Table />, aby budować bardziej złożone tabele danych. Połącz go z @tanstack/react-table, aby tworzyć tabele z sortowaniem, filtrowaniem i paginacją.

Zobacz dokumentację Data Table, aby uzyskać więcej informacji.

Możesz również zobaczyć przykład tabeli danych w demonstracji Tasks.

RTL

Aby włączyć obsługę RTL w Neobrutalism, zobacz przewodnik konfiguracji RTL.

"use client"

import * as React from "react"

Dostępność

Renderowanie natywnych elementów tabeli daje czytnikom ekranu zapowiedź tabeli, nawigację po wierszach i kolumnach oraz powiązanie komórek z nagłówkami bez żadnego podpinania ARIA. Nazwij każdą tabelę za pomocą TableCaption, a TableHead zarezerwuj dla prawdziwych komórek nagłówkowych. Kontener przewijania nie jest fokusowalny, więc użytkownicy korzystający wyłącznie z klawiatury nie przewiną tabeli, która się nie mieści — jeśli szerokie tabele są prawdopodobne, dodaj tabIndex={0}, role="region" i aria-label do kontenera div w swojej kopii komponentu.