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

الشرائح

احصل على Ritla UI

عناصر تفاعلية صغيرة: تقترح أو تنفّذ اختصارًا أو تصفّي أو تحمل قيمًا مُدخلة أو تعمل خيارات متعددة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add chip

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

  2. الاعتماديات التي يضيفها

    @base-ui/react@phosphor-icons/react

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

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

الاستخدام

chip.tsx
import { FilterChip, SuggestionChip } from "@/components/ui/chip";<SuggestionChip size="lg" onClick={() => setAmount(100)}>100 SAR</SuggestionChip><FilterChip defaultSelected>Income</FilterChip>

أمثلة

شريحة المساعدة

اختصار بأيقونة أو علم، وعدد اختياري بـbadge.

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

شريحة التصفية

زر تبديل: المحددة تُظهر علامة صح، وcaret يضيف سهمًا لشريحة تفتح خياراتها.

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

شريحة الإدخال

قيمة اختارها الشخص؛ onRemove يضيف زر حذف باسم واضح (إزالة ليلى حداد).

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

شريحة الاختيار المتعدد

خيار في اختيار متعدد بمربع تفعيل حقيقي؛ الشريحة كلها تسميته.

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

مرجع الخصائص

SuggestionChip / AssistChip

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label.
size"sm" | "lg""sm"خاصية Size: ‏24 أو 32 بكسل.
badgeReactNodeلا يوجدخاصية Show Badge: عدد بعد النص.
leading / flagIconComponent | ReactNode / stringلا يوجدللمساعدة: خاصية Style = Icon أو Flag.
…button propsComponentProps<"button">لا يوجد‏onClick وdisabled وغيرها.

FilterChip

الخاصيةالنوعالافتراضيالوصف
selected / defaultSelectedbooleanلا يوجدخاصية Selected.
onSelectedChange(selected: boolean) => voidلا يوجدعند التبديل.
caretbooleanfalseخاصية Show Trailing: سهم وهي محددة.

InputChip

الخاصيةالنوعالافتراضيالوصف
leading / flagIconComponent | ReactNode / stringلا يوجدخاصية Leading: أيقونة أو صورة شخصية أو علم.
onRemove() => voidلا يوجديضيف زر الحذف.
disabledbooleanلا يوجدمعطّلة.

CheckboxChip

الخاصيةالنوعالافتراضيالوصف
checked / defaultChecked / onCheckedChange…لا يوجدخاصية Selected، كما في Checkbox.
leading / flagIconComponent | ReactNode / stringلا يوجدخاصية Leading.
name / value / disabled…لا يوجدللنماذج.

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

الشريحة عنصر تحكم يضغطه الناس. هنا: الفرق بينها وبين الوسم، وأي شريحة تختار، وكيف تسير في العربية، وما تتحقق منه قبل التسليم.

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

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

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

2. اختيار الشريحة

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

افعل

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

تجنّب

  • استخدام الشرائح للإجراءات الرئيسية؛ استخدم الأزرار.
  • الجمع بين شرائح الترشيح وشرائح مربع الاختيار في صف واحد.
  • إخفاء المرشّحات المختارة خارج الشاشة.

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

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

قبل التسليم

  • وسوم للحالات، وشرائح لكل ما يُضغط.
  • سلوك الشريحة مدوّن: يُطبَّق فورًا، أو قابل للإزالة، أو يُحفظ عند الإرسال.
  • الشاشات العربية تستخدم النسخ العربية.

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

لوحة المفاتيح

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
Tabبين الشرائح وأزرار الحذف.
SpaceEnterينفّذ الشريحة أو يبدّلها (مربع التفعيل بـSpace).

ARIA

  • شرائح الاقتراح والمساعدة أزرار؛ شريحة التصفية زر بـaria-pressed؛ شريحة الاختيار role="checkbox" مسمّى بنصه.
  • زر الحذف مسمّى «إزالة» واسم القيمة بلغة الصفحة.
  • بعد الحذف ينتقل التركيز إلى زر حذف الشريحة التالية، أو السابقة إن لم تكن بعدها شريحة، فلا يضيع. وبعد حذف آخر شريحة، أعِد التركيز بنفسك إلى حقل الإدخال.
  • مساحة اللمس ٤٨ بكسل ارتفاعًا حتى للشريحة الصغيرة.

افعل

  • شريحة التصفية تُعلن إن كانت مفعّلة أم لا (aria-pressed).
  • سمِّ زر الإزالة باسم القيمة.
  • مساحة لمس بارتفاع 48 بكسل، يضيفها الكود.

تجنّب

  • الاعتماد على اللون وحده لإظهار المرشّح المفعّل؛ علامة الصح تظهره أيضًا.

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

ينعكس

  • الأيقونات والأعلام ومربع التفعيل في بداية الشريحة (اليمين)، وزر الحذف والسهم في نهايتها.

لا ينعكس

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

افعل

  • استخدم النسخ العربية للشرائح في الشاشات العربية.
  • ابدأ صف الشرائح من اليمين.
  • اكتب تسميات الشرائح بالعربية أصلًا.

تجنّب

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

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

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

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