نظرة عامة
تعرضBadge معلومات مضمنة موجزة، بما في ذلك التسميات القصيرة والأعداد. استخدم Tag للفئات، وChip لعناصر التحكم الموجزة، أو Status لحالة مسماة مع مؤشر.
استخدام
span غير تفاعلي.
مع أيقونة
aria-hidden واحتفظ بتسمية مرئية لشرح المحتوى.
المظهر
size القيم xs أو sm أو md. يقبل color القيم tertiary وinherit وprimary وsecondary وaccent. يقترن تنسيق accent بتعبئة accent-tertiary ونص accent11 في كلا النسقين. تحتفظ معالجة primary الصلبة بتعبئتها الزرقاء ونصها ذي اللون المميز. يقبل shape القيمة pill أو circle. القيم الافتراضية هي sm وtertiary وpill. تتميز المعالجة الدائرية بعرض ثابت يساوي ارتفاعها. استخدم pill للمحتوى الأطول، بما في ذلك الأعداد المختصرة.
الأعداد والظهور
aria-label أو aria-labelledby.
التركيب الأصلي
className وstyle وref عنصر الجذر الفعلي. يقبل render عنصرًا أو دالة رد نداء من خلال تركيب Base UI. اختر مالكًا أصليًا مناسبًا للمحتوى التفاعلي:
الإزاحة
تُنشأ الأنواع والقيم الافتراضية من النوع العامBadgeProps. تُقبل أيضًا السمات الأصلية ومعالجات الأحداث.
ReactNode
Caller-provided text, numbers, icons, or other inline content.
"accent" | "inherit" | "primary" | "secondary" | "tertiary"
افتراضي:"tertiary"
Neutral tertiary, inherited text, solid primary accent, soft accent tint, or secondary treatment.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the default span. Native props, handlers, and the ref target the rendered element.
"circle" | "pill"
افتراضي:"pill"
Rounded pill label or fixed circle with width equal to its height. Use pill for longer content.
"md" | "sm" | "xs"
افتراضي:"sm"
Compact height, font size, and spacing: xs, sm, or md.