الشرائح
عناصر تفاعلية صغيرة: تقترح أو تنفّذ اختصارًا أو تصفّي أو تحمل قيمًا مُدخلة أو تعمل خيارات متعددة.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add chipويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/chipالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { FilterChip, SuggestionChip } from "@/components/ui/chip";<SuggestionChip size="lg" onClick={() => setAmount(100)}>100 SAR</SuggestionChip><FilterChip defaultSelected>Income</FilterChip>أمثلة
شريحة التصفية
زر تبديل: المحددة تُظهر علامة صح، وcaret يضيف سهمًا لشريحة تفتح خياراتها.
شريحة الإدخال
قيمة اختارها الشخص؛ onRemove يضيف زر حذف باسم واضح (إزالة ليلى حداد).
شريحة الاختيار المتعدد
خيار في اختيار متعدد بمربع تفعيل حقيقي؛ الشريحة كلها تسميته.
مرجع الخصائص
SuggestionChip / AssistChip
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label. |
size | "sm" | "lg" | "sm" | خاصية Size: 24 أو 32 بكسل. |
badge | ReactNode | لا يوجد | خاصية Show Badge: عدد بعد النص. |
leading / flag | IconComponent | ReactNode / string | لا يوجد | للمساعدة: خاصية Style = Icon أو Flag. |
…button props | ComponentProps<"button"> | لا يوجد | onClick وdisabled وغيرها. |
FilterChip
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
selected / defaultSelected | boolean | لا يوجد | خاصية Selected. |
onSelectedChange | (selected: boolean) => void | لا يوجد | عند التبديل. |
caret | boolean | false | خاصية Show Trailing: سهم وهي محددة. |
InputChip
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
leading / flag | IconComponent | ReactNode / string | لا يوجد | خاصية Leading: أيقونة أو صورة شخصية أو علم. |
onRemove | () => void | لا يوجد | يضيف زر الحذف. |
disabled | boolean | لا يوجد | معطّلة. |
CheckboxChip
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
checked / defaultChecked / onCheckedChange | … | لا يوجد | خاصية Selected، كما في Checkbox. |
leading / flag | IconComponent | 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.
افعل
- استخدم النسخ العربية للشرائح في الشاشات العربية.
- ابدأ صف الشرائح من اليمين.
- اكتب تسميات الشرائح بالعربية أصلًا.
تجنّب
- شرائح بالنسخة الإنجليزية وتسميات عربية.
- ترجمة التسميات حرفيًا حين توجد كلمة عربية أقصر.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.