패턴
Column Settings Panel
표 열 표시·순서 설정(키보드로 이동).
조회 정보 설정
- 재직 상태
- 사번
- 입사일
- 이메일
import { useState } from 'react'
import { ColumnSettingsPanel, type ColumnSetting } from '@zest/patterns/ColumnSettingsPanel.js'
const initial: ColumnSetting[] = [
{ key: 'status', label: '재직 상태', visible: true }, { key: 'no', label: '사번', visible: true },
{ key: 'joined', label: '입사일', visible: true }, { key: 'email', label: '이메일', visible: false },
]
export default function Demo() {
const [cols, setCols] = useState(initial)
return <ColumnSettingsPanel className="w-full max-w-[320px]" columns={cols} onChange={setCols} onReset={() => setCols(initial)} />
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/column-settings-panel패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { ColumnSettingsPanel } from '@/components/zest/column-settings-panel'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
| prop | 타입 | 설명 |
|---|---|---|
columns | ColumnSetting[] | — |
onChange | (columns: ColumnSetting[]) => void | — |
onReset? | (() => void) | — |
title? | string | — |
className? | string | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.