패턴
Page Header
큰 제목 + 회색 형제 + 탭 + 도구 줄.
import { Plus } from 'lucide-react'
import { useState } from 'react'
import { FilterBar } from '@zest/patterns/FilterBar.js'
import { PageHeader } from '@zest/patterns/PageHeader.js'
import { Button } from '@zest/primitives/Button.js'
export default function Demo() {
const [tab, setTab] = useState('all')
return (
<div className="w-full">
<PageHeader
title="구성원 관리"
siblings={[{ label: '조직도', href: '#' }, { label: '인사 정보', href: '#' }]}
tabs={[{ value: 'all', label: '전체' }, { value: 'in', label: '입사' }, { value: 'out', label: '퇴사' }]}
tab={tab}
onTabChange={setTab}
actions={<Button leftIcon={<Plus />}>구성원 추가하기</Button>}
toolbar={<FilterBar chips={[{ id: 's', label: '재직 상태', value: '재직', onRemove: () => {} }]} onAdd={() => {}} count={42} />}
/>
</div>
)
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/page-header패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { PageHeader } from '@/components/zest/page-header'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
PageHeader
| prop | 타입 | 설명 |
|---|---|---|
title | string | — |
siblings? | { label: string; href: string; }[] | 형제 메뉴 — 같은 크기 회색 제목으로 나란히 (flex 의 「구성원 관리 · 조직도 관리」) |
tabs? | { value: string; label: string; count?: number | undefined; }[] | — |
tab? | string | — |
onTabChange? | ((value: string) => void) | — |
actions? | ReactNode | 오른쪽 위 주 행동 |
toolbar? | ReactNode | 탭 아래 도구 줄(필터 칩·검색·보기 옵션) |
children? | ReactNode | 본문. 탭이 있으면 현재 탭 패널 안에 들어간다. |
className? | string | — |
PageContainer
| prop | 타입 | 설명 |
|---|---|---|
width? | "fluid" | "detail" | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.