데이터와 피드백@neumorphism-ui/badge

Badge

다섯 가지 변형을 제공하는 가벼운 span 기반 컴포넌트입니다. 시각적 강조만 제공하고 별도의 상호작용이나 암묵적 ARIA role은 추가하지 않습니다.

@neumorphism-ui/badge
Registry JSON

미리보기

DefaultPrimarySoftOutlineDestructive

설치

설치: badgenpx shadcn@latest add @neumorphism-ui/badge

CLI가 npm 의존성, base 토큰, utils와 컴포넌트 소스를 순서대로 확인하고 설치합니다.

Registry를 처음 사용한다면 namespace 설정 을 먼저 완료하세요.

사용법

Import

Badge import 코드
import { Badge } from "@/components/ui/badge"

Example

Badge 사용 코드
<div className="flex gap-2">
  <Badge>Default</Badge>
  <Badge variant="primary">Ready</Badge>
  <Badge variant="soft">Draft</Badge>
  <Badge variant="destructive">Failed</Badge>
</div>

API 레퍼런스

컴포넌트속성타입기본값설명
Badgevariant"default" | "primary" | "soft" | "outline" | "destructive""default"상태의 강조 수준과 색상을 선택합니다.
Badgechildren필수React.ReactNode—짧은 상태 또는 분류 텍스트입니다.
BadgeclassNamestring—크기, 간격, 색상을 확장합니다.

접근성

  • 01

    Badge는 기본적으로 span이므로 상태에 맞는 텍스트를 직접 제공해야 합니다.

  • 02

    색상만으로 상태를 구분하지 말고 Ready, Failed 같은 명시적 문구를 사용합니다.

  • 03

    클릭 동작이 필요하면 Badge에 이벤트를 붙이지 말고 Button 또는 링크 안에서 사용합니다.