카드
제목·설명·액션이 있는 콘텐츠 섹션을 묶는 컨테이너다. 단순한 테두리 박스가 아니라, 하나의 의미 있는 정보 단위를 구성할 때 쓴다. 제목 없는 컨테이너는 Box, 숫자 지표는 StatCard, 엔티티와 복수 지표는 DataStatCard 를 우선 고려한다.
활용 방법
정보 카드
헤더에 제목·설명·보조 액션을 두고, 본문에 핵심 내용을 넣는다.
Preview
계약
이번 달 갱신 대상
3건
₩12.4M
예상 매출
tsx
<Card title="계약" description="이번 달 갱신 대상" action={<Badge tone="warning">3건</Badge>}><div>₩12.4M</div><p>예상 매출</p></Card>
하단 액션
footer 는 본문과 분리된 액션 영역이 필요할 때 쓴다.
Preview
API 키
외부 연동에 사용
sk_live_•••••••••••• tsx
<Cardtitle="API 키"description="외부 연동에 사용"footer={<Button size="sm">재발급</Button>}><code>sk_live_••••••</code></Card>
패딩
밀도 높은 목록은 sm, 일반 섹션은 base, 여유 있는 설정 화면은 lg 를 쓴다.
Preview
sm
조밀한 카드
base
기본 카드
lg
여유 카드
tsx
<Card title="sm" padding="sm">...</Card><Card title="base" padding="base">...</Card><Card title="lg" padding="lg">...</Card>
언제 쓰지 않나
- · 단순히 배경·테두리·패딩만 필요하면 Box 를 쓴다.
- · 대시보드 숫자 지표는 StatCard 를 쓴다.
- · 엔티티와 여러 지표가 함께 있으면 DataStatCard 를 쓴다.
속성
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| title | ReactNode | - | 카드 제목 |
| description | ReactNode | - | 카드 보조 설명 |
| action | ReactNode | - | 헤더 우측 액션/상태 |
| children | ReactNode | - | 본문 |
| footer | ReactNode | - | 하단 액션/보조 정보 영역 |
| padding | "sm" | "base" | "lg" | "base" | 내부 여백 |
| className | string | - | 폭·그림자 등 롱테일 조절 |