table-patterns
Create and enhance data tables with proper patterns, design tokens, and features
- License 许可
- MIT
- 最近更新
- 2026-08-26
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- table-patterns
- license
- MIT
- metadata
- { "version": "1.0" }
- description
- Create and enhance data tables with proper patterns, design tokens, and features
- allowed-tools
- [ "Read", "Write", "Glob", "Grep" ]
- compatibility
- Claude Code
03 SKILL.md 正文
Table Patterns Skill
When to use this skill
Use when creating or modifying data tables. This skill ensures:
- Proper use of DataTable component and TanStack Table
- Design token compliance (no hardcoded colors)
- Loading states and empty states
- Accessibility and keyboard navigation
Available Components
Core Components
Located in src/components/ui/data-table/:
| Component | Purpose |
|---|---|
DataTable |
Main table wrapper with TanStack Table |
DataTableToolbar |
Search, filters, export, column toggle |
DataTablePagination |
Page navigation controls |
DataTableColumnHeader |
Sortable column headers |
DataTableResizable |
Column resizing capability |
DataTableRowExpansion |
Expandable row details |
DataTableColumnReorder |
Drag-and-drop column ordering |
DataTableAdvancedFilter |
Complex filtering UI |
DataTableBulkActions |
Multi-row action toolbar |
DataTableDensity |
Row height presets (xs/sm/md/lg/xl) |
DataTableExport |
CSV/JSON export functionality |
DataTableFilterTabs |
Tab-based filtering |
Basic Usage
import { DataTable } from '@/components/ui/data-table/data-table';
import { ColumnDef } from '@tanstack/react-table';
const columns: ColumnDef<DataType>[] = [
{
accessorKey: 'name',
header: 'Name',
},
{
accessorKey: 'status',
header: 'Status',
cell: ({ row }) => (
<Badge variant={getVariant(row.original.status)}>
{row.original.status}
</Badge>
),
},
];
<DataTable
columns={columns}
data={data}
searchKey="name"
searchPlaceholder="Search..."
density="md"
striped={true}
showExport={true}
showColumnToggle={true}
onRowClick={(row) => handleRowClick(row)}
/>
Column Definition Patterns
Basic Column
{
accessorKey: 'title',
header: 'Title',
}
Sortable Column with Custom Header
import { DataTableColumnHeader } from '@/components/ui/data-table/data-table-column-header';
{
accessorKey: 'name',
header: ({ column }) => (
<DataTableColumnHeader column={column} title="Name" />
),
}
Column with Badge (DESIGN TOKEN COMPLIANT)
import { Badge } from '@/components/ui/badge';
{
accessorKey: 'status',
header: 'Status',
cell: ({ row }) => {
const status = row.original.status;
// Use Badge variants — NOT hardcoded colors
const variant = status === 'active' ? 'success'
: status === 'pending' ? 'warning'
: status === 'error' ? 'destructive'
: 'secondary';
return <Badge variant={variant}>{status}</Badge>;
},
}
CRITICAL: Color Token Compliance
BANNED — Hardcoded Colors
// NEVER DO THIS
const badgeColors = {
blue: 'bg-blue-500/20 text-blue-400 border-blue-500/30',
green: 'bg-emerald-500/20 text-emerald-400 border-emerald-500/30',
};
REQUIRED — Design Tokens
// Use Badge component variants
<Badge variant="success">Active</Badge>
<Badge variant="warning">Pending</Badge>
<Badge variant="destructive">Error</Badge>
<Badge variant="secondary">Draft</Badge>
Loading States
Skeleton Loading
import { Skeleton } from '@/components/ui/skeleton';
function TableSkeleton({ rows = 5, columns = 4 }) {
return (
<div className="space-y-4">
<div className="flex justify-between">
<Skeleton className="h-10 w-64" />
<Skeleton className="h-10 w-32" />
</div>
<div className="border rounded">
{Array.from({ length: rows }).map((_, i) => (
<div key={i} className="flex p-4 border-b last:border-0">
{Array.from({ length: columns }).map((_, j) => (
<Skeleton key={j} className="h-4 flex-1 mx-2" />
))}
</div>
))}
</div>
</div>
);
}
Empty States
Distinguish "No Data" vs "No Search Results"
// No search results
{searchQuery && data.length === 0 && (
<div className="text-center py-12">
<h3>No results for "{searchQuery}"</h3>
<p>Try adjusting your search or filters</p>
<Button variant="outline" onClick={clearSearch}>Clear search</Button>
</div>
)}
// Empty data
{!searchQuery && data.length === 0 && (
<div className="text-center py-12">
<h3>No items yet</h3>
<p>Get started by creating your first item</p>
<Button onClick={onCreate}>Create item</Button>
</div>
)}
Density Settings
Available density values (per Carbon Design System):
| Density | Row Height | Use Case |
|---|---|---|
xs |
24px | Compact data, dashboards |
sm |
32px | Dense lists |
md |
40px | Default, balanced |
lg |
48px | Touch-friendly |
xl |
64px | Prominent data |
<DataTable
density="md"
striped={true}
/>
Checklist
When creating or modifying tables:
- [ ] Uses
DataTablecomponent (not custom implementation) - [ ] Column colors use design tokens (no bg-blue-500, etc.)
- [ ] Loading state implemented with skeletons
- [ ] Empty state distinguishes no-data vs no-results
- [ ] Badge/status columns use
Badgecomponent variants - [ ] Density prop set appropriately
- [ ] Striped prop enabled for better row distinction
04 同仓库更多 Skills
vertical-grid
Enforce Swiss-Industrial 4px baseline vertical grid for consistent rhythm
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
valid-skill
A complete test skill with all optional directories.
swiss-design
Enforce Swiss design principles - reduce visual noise, remove harsh borders
supabase-postgres-best-practices
Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
settings-page-create
Create settings pages following established patterns and design system