الانتقال إلى المحتوى الرئيسي

نظرة عامة

تعرض 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. اختر مالكًا أصليًا مناسبًا للمحتوى التفاعلي:
يتولى Button المعروض سلوك التنقل ودلالات الرابط. تحتفظ الشارة بوضعها الافتراضي التقديمي ولا تستنتج التفاعل من محتواها.

الإزاحة

تُنشأ الأنواع والقيم الافتراضية من النوع العام 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.