본문으로 건너뛰기
zest/ui

컴포넌트

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

설치

shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.

npx shadcn@latest add @zest/table

패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내

사용법

import { DataTable } from '@/components/ui/table'

위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.

API

prop타입설명
columnsDataTableColumn<T>[]—
rowsT[]—
getRowId(row: T) => string—
captionstring스크린리더용 표 이름
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 로도 연다.