컴포넌트
Data Table
선택·고정 헤더·말줄임·빈 상태를 갖춘 표.
| 이름 | 재직 상태 | 입사일 | 이메일 | |
|---|---|---|---|---|
| 강서윤UX 디자이너 | 재직 | 2025. 12. 9 | seoyun.kang@zest.example | |
| 구현우백엔드 개발자 | 재직 | 2026. 4. 1 | hyunwoo.koo@zest.example | |
| 권나래PM | 입사 예정 | 2026. 12. 1 | narae.kwon@zest.example | |
| 박준서데이터 엔지니어 | 퇴사 | 2024. 9. 2 | junseo.park@zest.example |
import { useState } from 'react'
import { Avatar } from '@zest/primitives/Avatar.js'
import { StatusDot } from '@zest/primitives/StatusDot.js'
import { DataTable, type DataTableColumn } from '@zest/primitives/Table.js'
type Row = { id: string; name: string; role: string; status: 'done' | 'wait' | 'plan'; joined: string; email: string }
const rows: Row[] = [
{ id: '1', name: '강서윤', role: 'UX 디자이너', status: 'done', joined: '2025. 12. 9', email: 'seoyun.kang@zest.example' },
{ id: '2', name: '구현우', role: '백엔드 개발자', status: 'done', joined: '2026. 4. 1', email: 'hyunwoo.koo@zest.example' },
{ id: '3', name: '권나래', role: 'PM', status: 'wait', joined: '2026. 12. 1', email: 'narae.kwon@zest.example' },
{ id: '4', name: '박준서', role: '데이터 엔지니어', status: 'plan', joined: '2024. 9. 2', email: 'junseo.park@zest.example' },
]
const label = { done: '재직', wait: '입사 예정', plan: '퇴사' } as const
const columns: DataTableColumn<Row>[] = [
{ key: 'name', header: '이름', width: 200, render: (r) => <span className="inline-flex items-center gap-2.5"><Avatar name={r.name} size={32} /><span><span className="block font-semibold text-ink-strong">{r.name}</span><span className="block text-caption text-ink-muted">{r.role}</span></span></span> },
{ key: 'status', header: '재직 상태', width: 120, render: (r) => <StatusDot status={r.status} label={label[r.status]} /> },
{ key: 'joined', header: '입사일', width: 120 },
{ key: 'email', header: '이메일', width: 220, truncate: true },
]
export default function Demo() {
const [sel, setSel] = useState<string[]>([])
return <div className="w-full overflow-hidden rounded-md border border-solid border-line"><DataTable caption="구성원 목록" columns={columns} rows={rows} getRowId={(r) => r.id} selectable selected={sel} onSelectedChange={setSel} /></div>
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/table패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { DataTable } from '@/components/ui/table'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
| prop | 타입 | 설명 |
|---|---|---|
columns | DataTableColumn<T>[] | — |
rows | T[] | — |
getRowId | (row: T) => string | — |
caption | string | 스크린리더용 표 이름 |
selectable? | boolean | — |
selected? | string[] | — |
onSelectedChange? | ((ids: string[]) => void) | — |
rowLabel? | ((row: T) => string) | 행에서 이름처럼 쓸 열(체크박스 접근 이름). 기본: 첫 열 |
stickyHeader? | boolean | 헤더 고정. 가로 스크롤 상자가 스크롤 기준이 되므로 상자 안에서 붙는다 — maxHeight 를 안 주면 화면 높이에 맞춘 기본값(calc(100dvh - 240px))을 쓴다. |
maxHeight? | string | number | — |
empty? | ReactNode | — |
onRowClick? | ((row: T) => void) | — |
className? | string | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.
접근성
행 클릭이 있으면 Enter·Space 로도 연다.