패턴
Stat Card
지표 + 증감 + 스파크라인. 좋아졌는지로 색을 정한다.
평균 근무 시간
158.7시간2.5%감소
연차 사용률
34%6.2%증가
오늘 외근
3명
import { StatCard } from '@zest/patterns/StatCard.js'
export default function Demo() {
return (
<div className="grid w-full grid-cols-1 gap-4 sm:grid-cols-3">
<StatCard label="평균 근무 시간" value="158.7" unit="시간" delta={{ value: -2.5, good: 'down' }} series={[162, 160, 161, 159, 160, 158.7]} />
<StatCard label="연차 사용률" value="34" unit="%" delta={{ value: 6.2, good: 'up' }} series={[20, 24, 27, 30, 34]} />
<StatCard label="오늘 외근" value="3" unit="명" />
</div>
)
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/stat-card패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { StatCard } from '@/components/zest/stat-card'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
| prop | 타입 | 설명 |
|---|---|---|
label | string | — |
value | string | — |
unit? | string | — |
delta? | { value: number; good: "up" | "down"; } | value = 증감률(%). good = 어느 방향이 좋은지 |
series? | number[] | 스파크라인 값 (2개 이상) |
className? | string | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.