배지

컴포넌트에 대한 빠른 인지와 탐색을 돕기 위해 컴포넌트 근처에 표시되는 작은 문자 또는 숫자 데이터이다.

컴포넌트에 대한 빠른 인지와 탐색을 돕기 위해 컴포넌트 근처에 표시되는 작은 문자 또는 숫자 데이터이다.

사용 지침

처리 상태(신청 완료·반려 등)나 새 알림 개수처럼 단어 한두 개로 식별 가능한 정보에 사용하고, 색상만으로 의미를 전달하지 않도록 텍스트와 함께 노출합니다.

예제

Default

Label
examples/badge/BadgeDefault.tsx
import { Badge } from "@/components/ui/dynamic/badge"

export default function BadgeDefault() {

Colors

defaultsecondarytertiarypointdestructivewarningsuccessinfo
defaultsecondarytertiarypointdestructivewarningsuccessinfo
defaultsecondarytertiarypointdestructivewarningsuccessinfo
examples/badge/BadgeColors.tsx
import { Badge, type BadgeVariant } from "@/components/ui/dynamic/badge"

const VARIANTS: ReadonlyArray<BadgeVariant> = [

Rounded

primary solidprimary outlineprimary pasteldanger soliddanger outlinedanger pastel
examples/badge/BadgeRounded.tsx
import { Badge } from "@/components/ui/dynamic/badge"

export default function BadgeRounded() {

Sizes

중형 (medium)대형 (large)소형 (small)
examples/badge/BadgeSizes.tsx
import { Badge } from "@/components/ui/dynamic/badge"

export default function BadgeSizes() {

Variants

SolidOutlinePastel
위험경고성공정보
examples/badge/BadgeVariants.tsx
import { Badge } from "@/components/ui/dynamic/badge"

export default function BadgeVariants() {

속성

이름타입기본값설명
aria-labelstringDefines a string value that labels the current element. @see aria-labelledby.
asChildbooleanfalse
classNamestring
disabledboolean | null
idstring
onClickMouseEventHandler<HTMLSpanElement>
size"lg" | "default" | "small" | null
styleCSSProperties
tabIndexnumber
type"outline" | "solid" | "pastel" | null
variant"default" | "outline" | "secondary" | "destructive" | "success" | "warning" | "info" | "tertiary" | "point" | null