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

مجموعة مربعات التفعيل

احصل على Ritla UI

مربعات تفعيل تحت تسمية واحدة، بنص مساعد أو خطأ مشترك، وخيار «الكل» اختياري يصير جزئيًا حين يُحدَّد بعضها.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add checkbox-group

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

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

    @base-ui/react

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

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

الاستخدام

checkbox-group.tsx
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>

أمثلة

الخطأ

error يلوّن كل المربعات ويضع الرسالة تحت المجموعة.

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

مرجع الخصائص

CheckboxGroup

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدخاصية Label، كعنوان legend.
value / defaultValuestring[]لا يوجدقيم المربعات المحددة.
onValueChange(value: string[]) => voidلا يوجدعند كل تبديل.
allValuesstring[]لا يوجدكل القيم، لخيار «الكل» (<Checkbox parent>).
required / helperText / error / disabled…لا يوجدكما في حقل الإدخال.

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

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

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

المفتاحما يفعله
TabSpaceTab بين المربعات، وSpace يبدّل.

ARIA

  • fieldset مع legend، والنص المساعد أو الخطأ مرتبط بالمجموعة.
  • خيار «الكل» aria-checked="mixed" حين يُحدَّد بعض الأبناء.

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

ينعكس

  • المربعات في بداية الأسطر (اليمين).

لا ينعكس

  • علامات الاختيار لا تنعكس.
الأرقام
لا أرقام.
الخط العربي
التسمية label-12 والخيارات label-16 بوزن Medium.

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

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

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