Yave System

DESIGN KIT

컴포넌트 카탈로그

디자인킷의 파운데이션 토큰과 모든 컴포넌트(ui 18 · block 26)를 실제로 렌더한 참고 페이지입니다. 목차로 이동하세요 — 새 UI는 이들을 조립하고, 프리미티브 클래스를 복붙하지 마세요.

목차 파운데이션 6 · ui 18 · block 26

파운데이션 — 토큰

임의 색·간격 리터럴 금지 — 여기 토큰만 사용합니다(check:design 강제).

색상

브랜드 램프(yave-50~950) — 프로젝트 브랜드에 맞게 이 값만 교체 가능.

50
100
200
300
400
500
600
700
800
900
950

표면 · 잉크

surface
surface-subtle
surface-muted
ink

시맨틱

success
warning
error
info

타이포그래피

Display

규모에 맞는 단순함

H1

섹션 제목

H2

페이지 제목

H3

카드 제목

Body Strong

강조 본문 · 라벨

Body

본문 단락입니다. 설명 문구에 사용합니다.

Caption

보조 텍스트 · 타임스탬프 (14px 최소)

Data lg / md / sm

1,280

간격 (스페이싱 스케일)

4px 그리드. p/m/gap 은 이 토큰만.

yave-1 · 4px
yave-2 · 8px
yave-4 · 16px
yave-6 · 24px
yave-8 · 32px
yave-12 · 48px
yave-16 · 64px
yave-24 · 96px

라운드 · 그림자

rounded-btn · shadow-soft
rounded-card · shadow-lift
shadow-glow

모션

앱 페이지는 차분한 마이크로 인터랙션만(hover·focus·스켈레톤). 스크롤 연출은 랜딩 전용. 아래 카드에 hover 하면 리프트가 동작합니다.

hover 리프트

duration-normal · ease-smooth

스켈레톤

스피너

상태 매트릭스

designkit §상호작용의 상태 계약을 실제 컴포넌트로 보여줍니다. hover·focus·active 는 아래 예제에 직접 상호작용해 확인하세요.

Button

default
disabled (prop)
loading (prop)
hover · focus · active (상호작용)

Input

default
focus (클릭해 보세요)
error (prop)
disabled

ui — 프리미티브

Button

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

38%
0% 100%
70

Progress

진행률 42%
한도에 가까움 91%
길이를 모르는 대기

Segmented

보기 방식
기간

Chip

Badge 는 읽는 표식, Chip 은 누르는 표식이다.

Spinner

불러오는 중 불러오는 중 불러오는 중 불러오는 중

Divider



Kbd

⌘+K Ctrl+Shift+P Esc

block — 컴포지트

SectionHeading

EYEBROW

섹션 제목

옵션 eyebrow + 제목 + 부제를 타입 스케일로 묶습니다.

FeatureCard

기능 A

아이콘 칩 + 제목 + 본문으로 구성된 기능 타일입니다.

기능 B

Card 프리미티브를 조립해 만든 컴포지트입니다.

기능 C

hover 옵션으로 리프트를 켤 수 있습니다.

StatCard

+4.2%

1,280

지표 A

-1.1%

942

지표 B

36.5%

지표 C

—

지표 D (아이콘 없음)

DataTable

항목 분류 수량
항목 A 유형 1 128
항목 B 유형 2 64
항목 C 유형 1 32

ListRow

  • A

    항목 1

    보조 설명 텍스트

    활성
  • B

    항목 2

    보조 설명 텍스트

    대기
  • 항목 3

항목 3

리스트 행의 "열기" 액션 — 실제 페이지는 상세로 이동하거나 편집 모달을 연다. (blocks/Modal + lib/kit)

EmptyState

표시할 항목이 없습니다

아직 생성된 데이터가 없습니다. 새 항목을 추가하면 여기에 표시됩니다.

Tabs

같은 tablist 시맨틱·배선(initTabs), variant 로 룩만 다름 — underline(기본) / segmented(토글형).

variant="underline" (기본)

개요 패널 — 탭을 클릭하거나 좌우 화살표로 이동하세요. aria-selected가 활성 탭을 표시합니다.

variant="segmented" (토글형)

일간 뷰 — 세그먼티드 컨트롤은 좁은 상호배타 뷰(기간·모드·필터) 전환에 적합합니다.

Alert

정보

시맨틱 알림 — border 단독(shadow 없이), 아이콘 병행.

성공

작업이 완료되었습니다.

Tooltip

힌트 — hover 또는 focus 시 노출

Time

서버는 항상 UTC(2026-01-02T00:00:00Z)를 보냅니다. 아래 값은 이 브라우저의 타임존(—)으로 다시 렌더된 것입니다.

mode="date"
mode="datetime"
mode="relative"

ConfirmDelete

삭제 버튼 → 모달 → 확인 단어(로케일별: 삭제/DELETE/削除) 정확 입력 시에만 활성 → 실제 삭제. 실제 삭제는 페이지가 yave:confirm-delete 이벤트로 수행합니다(여기선 토스트로 시연).

삭제 대상 항목

확인 단어를 입력해야 삭제 버튼이 활성화됩니다.

삭제 확인

이 작업은 되돌릴 수 없습니다. 계속하려면 아래 단어를 정확히 입력하세요.

삭제

FormField

회사 이메일을 입력하세요

올바른 이메일 형식이 아닙니다

언제든 변경할 수 있습니다

Avatar

같은 주소는 어디서나 같은 글자·같은 색입니다(designkit §Avatar 크기 sm/md/lg).

A M S 7

Meter

90% 이상이면 색이 바뀌고 경고 문구가 함께 붙습니다(색만으로 상태를 말하지 않습니다).

항목 A 240 / 1,000
항목 B 930 / 1,000

한도의 90% 를 넘었습니다

LineChart

추이 영역 차트. 스크립트도 모션도 없고, 색은 토큰 유틸만 씁니다.

1234567

최저 12 · 최고 31

BarChart

구간 비교 막대. 최고값 막대만 브랜드색으로 강조하고 그 값을 글자로도 적습니다.

1234567

최고 6 · 31

Pagination

현재 페이지는 색과 함께 aria-current="page" 로도 표시됩니다.

Accordion

네이티브 <details> 라 JS 없이도 여닫힙니다. mode="single" 은 한 번에 하나만 엽니다.

이 컴포넌트는 언제 쓰나요?

문답이 길고 한 번에 하나만 읽으면 되는 자리에 씁니다.

JS 가 꺼져 있으면요?

여닫기는 그대로 됩니다. 한 번에 하나만 열리는 규칙만 빠집니다.

제목 안에 아이콘을 넣을 수 있나요?

항목마다 icon 을 주면 제목 앞에 붙습니다.

Stepper

완료는 체크, 현재는 번호와 굵기, 예정은 흐린 번호 — 상태가 색이 아니라 형태로도 갈립니다.

Rating

읽기 전용일 때는 수치를 글자로도 냅니다 — 별만 그리면 스크린리더에 아무것도 남지 않습니다.

4.5/55점 만점에 4.5점 3/5후기 128개5점 만점에 3점
별점

Toast

컴포넌트가 아니라 런타임 함수 showToast({ title, message?, variant? })(lib/toast)입니다. 아래 버튼을 눌러 우하단 팝업을 확인하세요.