الشارة
عدد (رسائل غير مقروءة، موافقات معلّقة) أو نقطة لشيء جديد، داخل التبويبات وعناصر التنقل والقوائم والصفوف. لكلمات الحالة استخدم الوسم.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add badgeويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/badgeأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Badge } from "@/components/ui/badge";<Badge tone="brand" count={3} label="unread messages" />أمثلة
الأنماط والمقاسات
خمسة ألوان، وon-brand للخلفيات بلون العلامة؛ lg وmd يعرضان العدد وsm نقطة. الأعداد فوق max (99) تظهر «99+».
مقاسات النقطة والحلقة
عند size="sm" يختار dotSize بين 6 و8 و10 و12 بكسل، ويضيف outline حلقة بلون الحدّ الباهت للون نفسه، لتنفصل النقطة عمّا تحتها.
مرجع الخصائص
Badge
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
tone | "neutral" | "brand" | "success" | "warning" | "danger" | "on-brand" | "neutral" | خاصية Tone. الخطر للأعداد العاجلة فقط. |
size | "lg" | "md" | "sm" | "md" | خاصية Size؛ sm نقطة بلا رقم. |
count | number | string | لا يوجد | خاصية Count؛ الرقم يُنسَّق بنظام الأرقام. |
max | number | 99 | ما فوقه يظهر «99+». |
label | ReactNode | لا يوجد | نص مخفي يُقرأ بعد العدد («رسائل غير مقروءة»)؛ النقطة بلا تسمية تُقرأ «جديد». |
numerals | "latn" | "arab" | لا يوجد | الافتراضي من RitlaProvider. |
dotSize | "xs" | "sm" | "md" | "lg" | "xs" | خاصية Size في _Dot عند size="sm": 6 و8 و10 و12 بكسل. |
outline | boolean | false | خاصية Outline في _Dot: حلقة بلون الحدّ الباهت للون حول النقطة. |
إرشادات الاستخدام
الشارة عدد أو نقطة مرفقة بشيء آخر. هنا: الشارة أم الوسم أم الشريحة، والألوان حسب المعنى، والأعداد والنقاط، وموضعها وأرقامها في العربية، وما تتحقق منه قبل التسليم.
1. شارة أم وسم أم شريحة
الشارة عدد أو نقطة مرفقة بشيء آخر. والكلمات التي تصف حالة («نشط»، «معلّق»، «متأخر») وسوم؛ والأشياء التي يختارها الناس أو يزيلونها شرائح.
| تحتاج إلى | استخدم | السبب |
|---|---|---|
| إظهار كم: 3 اعتمادات معلّقة | شارة، md أو lg | رقم يتصرف الناس بناءً عليه. |
| إظهار أن هناك جديدًا | شارة، sm (نقطة) | المهم الوجود، لا الرقم. |
| وصف حالة: «نشط»، «متأخر» | وسم | كلمة، لا عدد. |
| إظهار مرشّح أو خيار يستطيع الناس إزالته | شريحة | يمكن الضغط عليها. |
| إظهار توفر شخص | حالة الصورة الرمزية | تنتمي إلى الشخص. |
2. الألوان حسب المعنى
اختر اللون لما يعنيه العدد، لا للزينة. معظم الأعداد رمادية أو بلون العلامة؛ ويُحفظ لون الخطأ لما هو عاجل أو فاشل، كي يبقى لافتًا.
| النمط | المعنى |
|---|---|
| رمادي | مجاميع محايدة: 12 مستندًا، 48 معاملة. |
| العلامة | عناصر غير مقروءة أو جديدة تدعو إلى نظرة. |
| نجاح | أعداد إيجابية: 3 دفعات مستلمة. |
| تحذير | تحتاج إلى انتباه قريبًا: بطاقتان تنتهيان. |
| خطأ | عاجل أو فاشل: دفعة واحدة فشلت. |
| على العلامة | أي عدد على سطح بلون العلامة. |
افعل
- الرمادي أو لون العلامة لمعظم الأعداد.
- احفظ لون الخطأ للعاجل أو الفاشل.
- استخدم «على العلامة» على أسطح العلامة.
تجنّب
- جعل كل شارة بلون الخطأ لجذب الانتباه.
- الاعتماد على اللون وحده لشرح معنى العدد.
3. الأعداد والنقاط
اعرض عددًا حين يغيّر الرقم ما يفعله الناس، ونقطة حين لا يهم إلا «هناك جديد». وحدّد الأعداد الطويلة عند 99+. وأخفِ الشارة عند الصفر، وامسحها حين يرى الناس ما تعدّه. وفي الكود تقول تسمية مخفية ما يُعدّ: «3 رسائل غير مقروءة».
حدّد الأعداد الطويلة
تبويب «الطلبات» بعناصر كثيرة.
افعل
- حدّد الأعداد عند 99+.
- أخفِ الشارة حين يكون العدد صفرًا.
- امسحها حين يفتح الناس ما تعدّه.
- مرّر تسمية لقارئات الشاشة: «رسائل غير مقروءة».
تجنّب
- عرض أرقام كبيرة بالضبط مثل 1,284 في شارة.
- عرض 0.
- إبقاء الشارة بعد أن يرى الناس كل شيء.
4. العربية والأرقام
تقع الشارة بعد تسميتها، عند نهاية السطر: إلى يسار التسمية العربية. وتتبع الأعداد إعداد الأرقام مثل كل رقم آخر في المنتج: 3 أو ٣. واستخدم الأرقام نفسها في الشارة والتسمية حولها.
الشارة تتبع التسمية
عنصر «الطلبات» بالعربية.
قبل التسليم
- أعداد حيث يهم الرقم، ونقاط حيث لا يهم إلا «جديد».
- الألوان مختارة حسب المعنى، ولون الخطأ للعاجل.
- سلوك الحد والصفر والمسح مدوّن.
- تسميات مخفية لما تعدّه كل شارة.
إمكانية الوصول
ARIA
- العدد نص يُقرأ مع معناه عبر
label(٣ رسائل غير مقروءة)؛ لا تعتمد على اللون وحده. - النقطة لها اسم مخفي، «جديد» افتراضيًا بلغة الصفحة.
افعل
- قل ما يعدّه العدد في نص مخفي: «3 اعتمادات معلّقة».
- النقطة تُقرأ «جديد» بلغة الصفحة.
- النقاط بتباين 3:1 مع الصفحة؛ يستخدم الكود ألوان الأيقونات.
تجنّب
- الاعتماد على اللون للتمييز بين العاجل والعادي.
- إعلان عدد بلا سياق: «3».
ملاحظات العربية والاتجاه
ينعكس
- الشارة تتبع موضعها في الصف: في نهاية السطر (اليسار) في العربية.
لا ينعكس
- «99+» تبقى بالترتيب نفسه: الرقم معزول باتجاه LTR.
- الأرقام
- العدد يتبع
numeralsأوRitlaProvider(غربية افتراضيًا)، ليطابق المبالغ في بقية الشاشة. - الخط العربي
-
label-12بوزن Medium؛ الشارة تطول مع السطر العربي.
افعل
- الشارة عند نهاية السطر بعد التسمية، أي إلى يسارها في العربية.
- اتبع إعداد الأرقام في المنتج للأعداد.
- اكتب 99+ بالأرقام نفسها التي في بقية الشاشة.
تجنّب
- وضع الشارة قبل التسمية العربية.
- الخلط بين الأرقام الغربية والمشرقية في شاشة واحدة.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- مخاطر اتجاه غير معزولة: أرقام هواتف وبريد إلكتروني ومقاطع لاتينية داخل نص عربي
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)