مجموعة مربعات التفعيل
مربعات تفعيل تحت تسمية واحدة، بنص مساعد أو خطأ مشترك، وخيار «الكل» اختياري يصير جزئيًا حين يُحدَّد بعضها.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add checkbox-groupويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/checkbox-groupالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Checkbox } from "@/components/ui/checkbox";import { CheckboxGroup } from "@/components/ui/checkbox-group";<CheckboxGroup label="Notify me by" value={value} onValueChange={setValue}> <Checkbox value="email">Email</Checkbox> <Checkbox value="sms">Text message</Checkbox></CheckboxGroup>أمثلة
مرجع الخصائص
CheckboxGroup
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | ReactNode | لا يوجد | خاصية Label، كعنوان legend. |
value / defaultValue | string[] | لا يوجد | قيم المربعات المحددة. |
onValueChange | (value: string[]) => void | لا يوجد | عند كل تبديل. |
allValues | string[] | لا يوجد | كل القيم، لخيار «الكل» (<Checkbox parent>). |
required / helperText / error / disabled | … | لا يوجد | كما في حقل الإدخال. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| TabSpace | Tab بين المربعات، وSpace يبدّل. |
ARIA
fieldsetمعlegend، والنص المساعد أو الخطأ مرتبط بالمجموعة.- خيار «الكل»
aria-checked="mixed"حين يُحدَّد بعض الأبناء.
ملاحظات العربية والاتجاه
ينعكس
- المربعات في بداية الأسطر (اليمين).
لا ينعكس
- علامات الاختيار لا تنعكس.
- الأرقام
- لا أرقام.
- الخط العربي
- التسمية
label-12والخياراتlabel-16بوزن Medium.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.