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 이벤트로 수행합니다(여기선 토스트로 시연).

삭제 대상 항목

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

Confirm deletion

This cannot be undone. Type the word below exactly to continue.

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)입니다. 아래 버튼을 눌러 우하단 팝업을 확인하세요.