패턴
Filter Bar
필터 칩 줄 + 결과 수 + 보기 저장.
42명
import { useState } from 'react'
import { FilterBar } from '@zest/patterns/FilterBar.js'
export default function Demo() {
const [chips, setChips] = useState([{ id: 'base', label: '기준일', value: '오늘' }, { id: 'st', label: '재직 상태', value: '재직 외 1개' }, { id: 'org', label: '조직', value: '플랫폼팀' }])
return (
<div className="w-full">
<FilterBar chips={chips.map((c) => ({ ...c, onRemove: c.id === 'base' ? undefined : () => setChips((p) => p.filter((x) => x.id !== c.id)) }))} onAdd={() => {}} count={42} onReset={() => {}} onSave={() => {}} />
</div>
)
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/filter-bar패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { FilterBar } from '@/components/zest/filter-bar'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
| prop | 타입 | 설명 |
|---|---|---|
chips | FilterChip[] | — |
onAdd? | (() => void) | — |
addLabel? | string | — |
right? | ReactNode | 칩 오른쪽 끝(검색·보기 옵션 등) |
count? | number | 결과 건수 — 「42명」처럼 단위까지 |
countUnit? | string | — |
onReset? | (() => void) | — |
onSave? | (() => void) | — |
className? | string | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.