DESIGN KIT
컴포넌트 카탈로그
디자인킷의 파운데이션 토큰과 모든 컴포넌트(ui 18 · block 26)를 실제로 렌더한 참고 페이지입니다. 목차로 이동하세요 — 새 UI는 이들을 조립하고, 프리미티브 클래스를 복붙하지 마세요.
목차 파운데이션 6 · ui 18 · block 26
파운데이션 — 토큰
임의 색·간격 리터럴 금지 — 여기 토큰만 사용합니다(check:design 강제).
색상
브랜드 램프(yave-50~950) — 프로젝트 브랜드에 맞게 이 값만 교체 가능.
표면 · 잉크
시맨틱
타이포그래피
규모에 맞는 단순함
섹션 제목
페이지 제목
카드 제목
강조 본문 · 라벨
본문 단락입니다. 설명 문구에 사용합니다.
보조 텍스트 · 타임스탬프 (14px 최소)
1,280
간격 (스페이싱 스케일)
4px 그리드. p/m/gap 은 이 토큰만.
라운드 · 그림자
모션
앱 페이지는 차분한 마이크로 인터랙션만(hover·focus·스켈레톤). 스크롤 연출은 랜딩 전용. 아래 카드에 hover 하면 리프트가 동작합니다.
hover 리프트
duration-normal · ease-smooth
스켈레톤
스피너
상태 매트릭스
designkit §상호작용의 상태 계약을 실제 컴포넌트로 보여줍니다. hover·focus·active 는 아래 예제에 직접 상호작용해 확인하세요.
Button
Input
ui — 프리미티브
Card
기본 카드
shadow-soft 표면 컨테이너입니다.
hover 카드
인터랙티브 그리드용 리프트.
muted 카드
surface-muted 표면.
Badge
Input
Skeleton
Toggle
Select
Checkbox
Radio
Textarea
Container
지면의 가로 폭은 이 여섯 계단뿐이다. 임의 max-w 를 새로 적지 않는다.
page 1280px wide 1080px content 960px readable 840px narrow 640px tight 480px Slider
Progress
Segmented
Chip
Badge 는 읽는 표식, Chip 은 누르는 표식이다.
Spinner
Divider
Kbd
block — 컴포지트
SectionHeading
EYEBROW
섹션 제목
옵션 eyebrow + 제목 + 부제를 타입 스케일로 묶습니다.
FeatureCard
기능 A
아이콘 칩 + 제목 + 본문으로 구성된 기능 타일입니다.
기능 B
Card 프리미티브를 조립해 만든 컴포지트입니다.
기능 C
hover 옵션으로 리프트를 켤 수 있습니다.
StatCard
1,280
지표 A
942
지표 B
36.5%
지표 C
—
지표 D (아이콘 없음)
DataTable
| 항목 | 분류 | 수량 |
|---|---|---|
| 항목 A | 유형 1 | 128 |
| 항목 B | 유형 2 | 64 |
| 항목 C | 유형 1 | 32 |
ListRow
- A
항목 1
보조 설명 텍스트
활성 - B
항목 2
보조 설명 텍스트
대기 -
항목 3
EmptyState
표시할 항목이 없습니다
아직 생성된 데이터가 없습니다. 새 항목을 추가하면 여기에 표시됩니다.
Tabs
같은 tablist 시맨틱·배선(initTabs), variant 로 룩만 다름 — underline(기본) / segmented(토글형).
variant="underline" (기본)
개요 패널 — 탭을 클릭하거나 좌우 화살표로 이동하세요. aria-selected가 활성 탭을 표시합니다.
variant="segmented" (토글형)
일간 뷰 — 세그먼티드 컨트롤은 좁은 상호배타 뷰(기간·모드·필터) 전환에 적합합니다.
Modal
Alert
정보
성공
주의
오류
Dropdown
Tooltip
Time
서버는 항상 UTC(2026-01-02T00:00:00Z)를 보냅니다. 아래 값은 이 브라우저의 타임존(—)으로 다시 렌더된 것입니다.
- mode="date"
- mode="datetime"
- mode="relative"
ConfirmDelete
삭제 버튼 → 모달 → 확인 단어(로케일별: 삭제/DELETE/削除) 정확 입력 시에만 활성 → 실제 삭제. 실제 삭제는 페이지가 yave:confirm-delete 이벤트로 수행합니다(여기선 토스트로 시연).
삭제 대상 항목
확인 단어를 입력해야 삭제 버튼이 활성화됩니다.
FormField
회사 이메일을 입력하세요
올바른 이메일 형식이 아닙니다
언제든 변경할 수 있습니다
PageHeader
제목 왼쪽 · 액션 오른쪽. 타이포는 level(태그)과 size(토큰)를 나눠 지정합니다.
지면 제목
한 줄 설명이 들어갑니다.
Avatar
같은 주소는 어디서나 같은 글자·같은 색입니다(designkit §Avatar 크기 sm/md/lg).
Meter
90% 이상이면 색이 바뀌고 경고 문구가 함께 붙습니다(색만으로 상태를 말하지 않습니다).
한도의 90% 를 넘었습니다
LineChart
추이 영역 차트. 스크립트도 모션도 없고, 색은 토큰 유틸만 씁니다.
최저 12 · 최고 31
BarChart
구간 비교 막대. 최고값 막대만 브랜드색으로 강조하고 그 값을 글자로도 적습니다.
최고 6 · 31
Pagination
현재 페이지는 색과 함께 aria-current="page" 로도 표시됩니다.
Carousel
스크롤 스냅 기반이라 스와이프·트랙패드·키보드가 그대로 동작합니다. 자동 재생은 없습니다.
-
슬라이드 1
카드 한 장이 슬라이드 하나입니다.
-
슬라이드 2
카드 한 장이 슬라이드 하나입니다.
-
슬라이드 3
카드 한 장이 슬라이드 하나입니다.
-
슬라이드 4
카드 한 장이 슬라이드 하나입니다.
-
슬라이드 5
카드 한 장이 슬라이드 하나입니다.
Accordion
네이티브 <details> 라 JS 없이도 여닫힙니다. mode="single" 은 한 번에 하나만 엽니다.
이 컴포넌트는 언제 쓰나요?
문답이 길고 한 번에 하나만 읽으면 되는 자리에 씁니다.
JS 가 꺼져 있으면요?
여닫기는 그대로 됩니다. 한 번에 하나만 열리는 규칙만 빠집니다.
제목 안에 아이콘을 넣을 수 있나요?
항목마다 icon 을 주면 제목 앞에 붙습니다.
Stepper
완료는 체크, 현재는 번호와 굵기, 예정은 흐린 번호 — 상태가 색이 아니라 형태로도 갈립니다.
Rating
읽기 전용일 때는 수치를 글자로도 냅니다 — 별만 그리면 스크린리더에 아무것도 남지 않습니다.
Toast
컴포넌트가 아니라 런타임 함수 showToast({ title, message?, variant? })(lib/toast)입니다. 아래 버튼을 눌러 우하단 팝업을 확인하세요.