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

الوسم

احصل على Ritla UI

يصف شيئًا بحالة أو فئة (مدفوع، معلّق، متأخر). غير تفاعلي: لا تجعله يبدو قابلًا للضغط.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add tag

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

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

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

الاستخدام

tag.tsx
import { Tag } from "@/components/ui/tag";<Tag tone="success" iconLeading={CheckCircleIcon}>Paid</Tag>

أمثلة

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

خمسة ألوان بنمطين subtle وsolid، ومقاسان، وأيقونة في البداية أو النهاية، أو علم بـflag.

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

مرجع الخصائص

Tag

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label: الكلمة تحمل الحالة لا اللون.
tone"neutral" | "brand" | "success" | "warning" | "danger""neutral"خاصية Tone.
emphasis"subtle" | "solid""subtle"خاصية Emphasis.
size"sm" | "md""md"خاصية Size.
iconLeading / iconTrailingIconComponentلا يوجدخاصية Style = Leading icon / Trailing icon.
flagstringلا يوجدخاصية Style = Flag: رمز الدولة (يحتاج @ritla/flags).

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

الوسم تسمية يقرؤها الناس: حالة أو فئة. هنا: الفرق بينه وبين الشريحة، وما تعنيه ألوانه، وكيف تكتبه، وكيف يسير في العربية، وما تتحقق منه قبل التسليم.

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

الوسوم تسميات: حالة أو فئة يقرؤها الناس، مثل «مدفوع» أو «متأخر». والشرائح عناصر تحكم: يضغط عليها الناس. إن كان الضغط يجب أن يفعل شيئًا فهي شريحة؛ وإلا فهي وسم، ويجب ألا يبدو قابلًا للضغط أبدًا.

المكوّنالاستخدام
وسمحالة أو فئة يقرؤها الناس. غير تفاعلي.
شريحة الاقتراحاختيارات سريعة يضغطها الناس: مبلغ، أو رد.
شريحة المساعدةإجراء مختصر يخص المحتوى، بأيقونة.
شريحة التصفيةتشغيل مرشّح أو إيقافه؛ يُطبَّق فورًا.
شريحة الإدخالقيمة أدخلها الناس أو اختاروها، بزر إزالة.
شريحة الاختيار المتعددعدة خيارات في نموذج، تُحفظ عند الإرسال.

2. ألوان الوسوم لها معنى

أعطِ كل لون معنى واحدًا في المنتج كله: النجاح للمنجز أو المدفوع، والتحذير للمنتظر أو ما يحتاج إلى انتباه، والخطأ للفاشل أو المتأخر، ولون العلامة للجديد أو المعلوماتي، والرمادي للفئات المحايدة. استخدم النمط الخفيف في الجداول والقوائم؛ واحفظ النمط المصمت للحالة الوحيدة التي يجب أن تبرز. والكلمة هي التي تحمل المعنى دائمًا.

خفيف في القوائم، والكلمات أولًا

حالات الدفع في جدول معاملات.

افعل: وسوم خفيفةثلاث حالات تُمسح بسهولة؛ والكلمات تقول ما حدث.
تجنّب: مصمت في كل مكانكل صف يصرخ، فلا شيء يبرز بعد ذلك.

افعل

  • اربط كل حالة بلون واحد والتزم به في كل مكان.
  • استخدم الوسوم الخفيفة في الجداول والقوائم.
  • اكتب الحالة كلمةً؛ واللون يدعمها فقط.

تجنّب

  • النمط المصمت لكل وسم في جدول.
  • لون واحد لمعانٍ مختلفة في شاشات مختلفة.
  • وسم ملوّن بلا نص.

3. كتابة الوسوم

الوسم كلمة أو كلمتان من مجموعة ثابتة: «مدفوع»، «معلّق»، «متأخر»، «مسترد». استخدم الكلمات نفسها حيثما ظهرت الحالة، ولا تجعل الوسم يبدو زرًا أبدًا.

افعل

  • قائمة ثابتة من كلمات الحالة في المنتج كله.
  • الوسوم كلمة أو كلمتان.
  • أضف أيقونة فقط حين تضيف معنى، والأيقونة نفسها للحالة نفسها.

تجنّب

  • كتابة جمل داخل وسم.
  • جعل الوسم قابلًا للنقر، أو إعطاؤه حالات تمرير.
  • اختراع كلمات جديدة للحالة نفسها في شاشات مختلفة.

4. العربية والاتجاه من اليمين إلى اليسار

استخدم النسخ العربية: تنتقل الأيقونات البادئة والأعلام وعلامات الصح إلى اليمين، والأيقونات اللاحقة وأزرار الإزالة إلى اليسار، ويبدأ صف الشرائح من اليمين. واكتب كلمات الحالة بالعربية أصلًا، وأبقِها قصيرة كما في الإنجليزية.

الوسوم تتبع التخطيط العربي

حالات الدفع بالعربية.

افعل: النسخ العربيةخط عربي وارتفاعات أسطر عربية؛ والأيقونات تقع على اليمين.
تجنّب: وسوم إنجليزية بكلمات عربيةالتسميات بخطوط لاتينية وارتفاعات أسطر إنجليزية.

قبل التسليم

  • وسوم للحالات، وشرائح لكل ما يُضغط.
  • كلمات الحالة وألوانها من قائمة ثابتة واحدة.
  • الشاشات العربية تستخدم النسخ العربية.

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

ARIA

  • نص عادي يُقرأ مع ما حوله؛ الأيقونات والعلم زخرفية.
  • لا تعتمد على اللون وحده.

افعل

  • أبقِ الوسم نصًا عاديًا يُقرأ في مكانه.

تجنّب

  • إعطاء الوسم دورًا أو تركيزًا.

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

ينعكس

  • الأيقونة الأولى والعلم في بداية السطر (اليمين)، والأيقونة الأخيرة في نهايته.

لا ينعكس

  • الأعلام وعلامات الحالة لا تنعكس.
الأرقام
الأرقام في الوسم تتبع numerals عبر formatNumber.
الخط العربي
‏label-14 (أو label-12 في الصغير) بوزن Medium؛ الوسم يطول مع السطر العربي.

افعل

  • استخدم النسخ العربية للوسوم في الشاشات العربية.
  • اكتب كلمات الحالة بالعربية أصلًا: «مدفوع» لا ترجمة حرفية.

تجنّب

  • وسوم بالنسخة الإنجليزية وتسميات عربية.
  • ترجمة كلمات الحالة حرفيًا حين توجد كلمة عربية أقصر.

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

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

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