Get startedFoundationsComponentsPatternsRules

Badge

배지는 개수나 변화량 같은 숫자 상태 정보를 작게 보여줘요.

설치

pnpm dlx shadcn@latest add https://rebar.conmarket-landing.workers.dev/r/steel/badge.json

Examples

Appearance

배지마다 정해진 의미가 있어요. 수치의 성격에 맞는 appearance 를 골라요.

Appearance용도
neutral기본값. 특별한 의미 없는 일반 숫자
information새로 생기거나 바뀐 정보, 알려줄 만한 수치
success증가·추가 같은 긍정적인 값
danger감소·삭제 같은 부정적인 값, 심각한 개수
warning대기 중인 작업처럼 주의가 필요한 값
discovery새 기능이나 탐색을 유도하는 정보
inverse어두운(반대 테마) 배경 위

Bold appearances

알림 개수처럼 꼭 눈에 띄어야 할 때만 bold appearance(informationBold, successBold, dangerBold, warningBold, discoveryBold)를 써요.

Legacy appearances

이전 이름도 받아요. default → neutral, primary → information, primaryInverted → inverse, added → success, removed·important → danger 로 그려져요.

Max value

숫자를 넘기면 max(기본 99)를 넘는 값은 99+ 처럼 잘라서 보여줘요. max={false} 면 값을 그대로 보여줘요. 음수도 그대로 표시돼요.

With label

배지는 무엇을 세는지 알려주는 라벨과 함께 둬요.

Usage guidelines

배지는 개수, 지표처럼 숫자로 된 상태 정보를 보여줘요. 변화량은 앞에 +, - 를 붙이고, 큰 수는 K(천), M(백만), 기간은 d(일)처럼 뒤에 줄임 글자를 붙여요. 숫자가 아닌 정보는 Lozenge 나 Tag 를 써요.

Do· 정해진 의미대로
수치의 성격에 맞는 시맨틱을 골라요. 제품마다 같은 색이 같은 의미를 가져야 해요.
Don't· 의미 바꾸기
예쁘다는 이유로 정해진 시맨틱에서 벗어난 색을 쓰지 않아요.
Do· 라벨과 함께
"업데이트 13"처럼 무엇을 세는지 라벨 옆에 둬요.
Don't· 라벨 없는 배지
툴팁도 없이 배지만 여러 개 늘어놓지 않아요.
  • bold 배지는 상단 내비게이션의 알림 수처럼 강조가 필요한 곳에만 아껴 써요. 목록의 로젠지 옆 같은 보조 요소에는 쓰지 않아요.

Accessibility

  • 배지는 상호작용하지 않는 텍스트라 키보드 포커스를 받지 않아요. 스크린리더는 숫자만 읽으므로, 무엇을 세는지 주변 라벨로 알려줘요. 라벨이 화면에 없다면 숨김 텍스트를 함께 둬요.
  • 숫자 구분 기호는 나라마다 달라요. 앱의 국제화 라이브러리나 Intl.NumberFormat 으로 사용자 로캘에 맞게 포맷한 문자열을 children 으로 넘겨요.

Props

Prop

Type

On this page