Badge · Overview

스토리북 개발자들을 위한 내부 문서

Components

Badge

Overview

상태, 카테고리, 수량 등 짧은 메타 정보를 레이블 형태로 표시하는 비인터랙티브 컴포넌트입니다. 텍스트나 UI 요소에 부가 맥락을 제공합니다.

Variants

뱃지의 시각 강도입니다. 기본값은 solid입니다.

  • Solid채워진 배경으로 높은 시각적 강조가 필요한 경우에 사용합니다. 페이지 내 사용 빈도를 낮게 유지하여 주목도를 유지합니다.
  • Subtle중립적인 메타 정보를 표현할 때 사용합니다. 카테고리 태그, 버전 레이블, 타입 표시 등 의미 없는(semantic 아닌) 분류에 적합합니다.
  • Soft상태·브랜드 틴트에 사용합니다. status 기본은 primary이며, fail · success · warning 또는 CSS 색 문자열로 커스텀합니다.

Solid

Solid

Subtle

Subtle

Soft

Soft
Sizes

뱃지 크기는 배치되는 컨텍스트에 따라 선택합니다. 기본값은 medium입니다.

  • Medium본문·리스트 옆 등 일반적인 맥락에 사용합니다.
  • Large헤더·카드 타이틀 등 더 큰 위계에 사용합니다.

Medium

SolidSubtleSoft

Large

SolidSubtleSoft
Colors

solid·subtle은 color prop으로 덮습니다. soft는 status로 제어합니다. 기본 primary, 프리셋(fail·success·warning) 또는 CSS 변수·hex·rgba 커스텀(텍스트색 + 틴트 배경).

  • Primarysoft 기본. --surface-primary-subtler / --text-primary.
  • Fail오류·실패 상태. --surface-error / --status-error.
  • Success성공·완료 상태. --surface-success / --status-success.
  • Warning주의·경고 상태. --surface-warning / --status-warning.

Default solid

Badge

color · primary

Primary

color · subtle

Primary

soft · primary

Primary

soft · fail

Fail

soft · success

Success

soft · warning

Warning

soft · status="#059669"

Hex

soft · status="rgba(…)"

RGBA

soft · status="var(--text-primary)"

Token