انتقل إلى المحتوى

الشارة

احصل على Ritla UI

عدد (رسائل غير مقروءة، موافقات معلّقة) أو نقطة لشيء جديد، داخل التبويبات وعناصر التنقل والقوائم والصفوف. لكلمات الحالة استخدم الوسم.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add badge

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/badge

  2. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

badge.tsx
import { Badge } from "@/components/ui/badge";<Badge tone="brand" count={3} label="unread messages" />

أمثلة

الأنماط والمقاسات

خمسة ألوان، وon-brand للخلفيات بلون العلامة؛ lg وmd يعرضان العدد وsm نقطة. الأعداد فوق max (99) تظهر «99+».

إنجليزيمعكوسعربي
← RTL

مقاسات النقطة والحلقة

عند size="sm" يختار dotSize بين 6 و8 و10 و12 بكسل، ويضيف outline حلقة بلون الحدّ الباهت للون نفسه، لتنفصل النقطة عمّا تحتها.

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

Badge

الخاصيةالنوعالافتراضيالوصف
tone"neutral" | "brand" | "success" | "warning" | "danger" | "on-brand""neutral"خاصية Tone. الخطر للأعداد العاجلة فقط.
size"lg" | "md" | "sm""md"خاصية Size؛ sm نقطة بلا رقم.
countnumber | stringلا يوجدخاصية Count؛ الرقم يُنسَّق بنظام الأرقام.
maxnumber99ما فوقه يظهر «99+».
labelReactNodeلا يوجدنص مخفي يُقرأ بعد العدد («رسائل غير مقروءة»)؛ النقطة بلا تسمية تُقرأ «جديد».
numerals"latn" | "arab"لا يوجدالافتراضي من RitlaProvider.
dotSize"xs" | "sm" | "md" | "lg""xs"خاصية Size في _Dot عند size="sm": 6 و8 و10 و12 بكسل.
outlinebooleanfalseخاصية Outline في _Dot: حلقة بلون الحدّ الباهت للون حول النقطة.

إرشادات الاستخدام

الشارة عدد أو نقطة مرفقة بشيء آخر. هنا: الشارة أم الوسم أم الشريحة، والألوان حسب المعنى، والأعداد والنقاط، وموضعها وأرقامها في العربية، وما تتحقق منه قبل التسليم.

1. شارة أم وسم أم شريحة

الشارة عدد أو نقطة مرفقة بشيء آخر. والكلمات التي تصف حالة («نشط»، «معلّق»، «متأخر») وسوم؛ والأشياء التي يختارها الناس أو يزيلونها شرائح.

تحتاج إلىاستخدمالسبب
إظهار كم: 3 اعتمادات معلّقةشارة، md أو lgرقم يتصرف الناس بناءً عليه.
إظهار أن هناك جديدًاشارة، sm (نقطة)المهم الوجود، لا الرقم.
وصف حالة: «نشط»، «متأخر»وسمكلمة، لا عدد.
إظهار مرشّح أو خيار يستطيع الناس إزالتهشريحةيمكن الضغط عليها.
إظهار توفر شخصحالة الصورة الرمزيةتنتمي إلى الشخص.

2. الألوان حسب المعنى

اختر اللون لما يعنيه العدد، لا للزينة. معظم الأعداد رمادية أو بلون العلامة؛ ويُحفظ لون الخطأ لما هو عاجل أو فاشل، كي يبقى لافتًا.

النمطالمعنى
رماديمجاميع محايدة: 12 مستندًا، 48 معاملة.
العلامةعناصر غير مقروءة أو جديدة تدعو إلى نظرة.
نجاحأعداد إيجابية: 3 دفعات مستلمة.
تحذيرتحتاج إلى انتباه قريبًا: بطاقتان تنتهيان.
خطأعاجل أو فاشل: دفعة واحدة فشلت.
على العلامةأي عدد على سطح بلون العلامة.

افعل

  • الرمادي أو لون العلامة لمعظم الأعداد.
  • احفظ لون الخطأ للعاجل أو الفاشل.
  • استخدم «على العلامة» على أسطح العلامة.

تجنّب

  • جعل كل شارة بلون الخطأ لجذب الانتباه.
  • الاعتماد على اللون وحده لشرح معنى العدد.

3. الأعداد والنقاط

اعرض عددًا حين يغيّر الرقم ما يفعله الناس، ونقطة حين لا يهم إلا «هناك جديد». وحدّد الأعداد الطويلة عند 99+. وأخفِ الشارة عند الصفر، وامسحها حين يرى الناس ما تعدّه. وفي الكود تقول تسمية مخفية ما يُعدّ: «3 رسائل غير مقروءة».

حدّد الأعداد الطويلة

تبويب «الطلبات» بعناصر كثيرة.

افعل: محدَّد عند 99+قصير ومتوازن، ويقول «الكثير» مع ذلك.
تجنّب: الرقم بالضبطشارة من أربعة أرقام تزاحم التسمية، ولا يقرأ أحد الرقم بالضبط.

افعل

  • حدّد الأعداد عند 99+.
  • أخفِ الشارة حين يكون العدد صفرًا.
  • امسحها حين يفتح الناس ما تعدّه.
  • مرّر تسمية لقارئات الشاشة: «رسائل غير مقروءة».

تجنّب

  • عرض أرقام كبيرة بالضبط مثل 1,284 في شارة.
  • عرض 0.
  • إبقاء الشارة بعد أن يرى الناس كل شيء.

4. العربية والأرقام

تقع الشارة بعد تسميتها، عند نهاية السطر: إلى يسار التسمية العربية. وتتبع الأعداد إعداد الأرقام مثل كل رقم آخر في المنتج: 3 أو ٣. واستخدم الأرقام نفسها في الشارة والتسمية حولها.

الشارة تتبع التسمية

عنصر «الطلبات» بالعربية.

افعل: بعد التسميةالعدد إلى يسار «الطلبات»، حيث ينتهي السطر العربي.
تجنّب: قبل التسميةيأتي العدد أولًا فيُقرأ جزءًا من عنصر آخر.

قبل التسليم

  • أعداد حيث يهم الرقم، ونقاط حيث لا يهم إلا «جديد».
  • الألوان مختارة حسب المعنى، ولون الخطأ للعاجل.
  • سلوك الحد والصفر والمسح مدوّن.
  • تسميات مخفية لما تعدّه كل شارة.

إمكانية الوصول

ARIA

  • العدد نص يُقرأ مع معناه عبر label (٣ رسائل غير مقروءة)؛ لا تعتمد على اللون وحده.
  • النقطة لها اسم مخفي، «جديد» افتراضيًا بلغة الصفحة.

افعل

  • قل ما يعدّه العدد في نص مخفي: «3 اعتمادات معلّقة».
  • النقطة تُقرأ «جديد» بلغة الصفحة.
  • النقاط بتباين 3:1 مع الصفحة؛ يستخدم الكود ألوان الأيقونات.

تجنّب

  • الاعتماد على اللون للتمييز بين العاجل والعادي.
  • إعلان عدد بلا سياق: «3».

ملاحظات العربية والاتجاه

ينعكس

  • الشارة تتبع موضعها في الصف: في نهاية السطر (اليسار) في العربية.

لا ينعكس

  • «99+» تبقى بالترتيب نفسه: الرقم معزول باتجاه LTR.
الأرقام
العدد يتبع numerals أو RitlaProvider (غربية افتراضيًا)، ليطابق المبالغ في بقية الشاشة.
الخط العربي
‏label-12 بوزن Medium؛ الشارة تطول مع السطر العربي.

افعل

  • الشارة عند نهاية السطر بعد التسمية، أي إلى يسارها في العربية.
  • اتبع إعداد الأرقام في المنتج للأعداد.
  • اكتب 99+ بالأرقام نفسها التي في بقية الشاشة.

تجنّب

  • وضع الشارة قبل التسمية العربية.
  • الخلط بين الأرقام الغربية والمشرقية في شاشة واحدة.

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R021مخاطر اتجاه غير معزولة: أرقام هواتف وبريد إلكتروني ومقاطع لاتينية داخل نص عربي
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)