Badge
다섯 가지 변형을 제공하는 가벼운 span 기반 컴포넌트입니다. 시각적 강조만 제공하고 별도의 상호작용이나 암묵적 ARIA role은 추가하지 않습니다.
@neumorphism-ui/badge미리보기
DefaultPrimarySoftOutlineDestructive
설치
설치: badge
npx shadcn@latest add @neumorphism-ui/badgeCLI가 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 레퍼런스
| 컴포넌트 | 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
Badge | variant | "default" | "primary" | "soft" | "outline" | "destructive" | "default" | 상태의 강조 수준과 색상을 선택합니다. |
Badge | children필수 | React.ReactNode | — | 짧은 상태 또는 분류 텍스트입니다. |
Badge | className | string | — | 크기, 간격, 색상을 확장합니다. |
접근성
- 01
Badge는 기본적으로 span이므로 상태에 맞는 텍스트를 직접 제공해야 합니다.
- 02
색상만으로 상태를 구분하지 말고 Ready, Failed 같은 명시적 문구를 사용합니다.
- 03
클릭 동작이 필요하면 Badge에 이벤트를 붙이지 말고 Button 또는 링크 안에서 사용합니다.