أزرار الاختيار
لاختيار خيار واحد فقط من قائمة قصيرة ظاهرة كلها؛ اختيار أحدها يلغي الباقي. الدائرة في بداية السطر.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add radioويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/radioالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Radio, RadioGroup } from "@/components/ui/radio";<RadioGroup label="Delivery" name="delivery" defaultValue="standard"> <Radio value="standard">Standard</Radio> <Radio value="express">Express</Radio></RadioGroup>أمثلة
الحالات والمقاس
error يلوّن كل الدوائر، وdisabled وreadOnly للمجموعة كلها، وsize="lg" الدائرة الكبيرة للمس بهالتها.
مرجع الخصائص
RadioGroup
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | ReactNode | لا يوجد | خاصية Label: اسم المجموعة. |
value / defaultValue | string | null | لا يوجد | الخيار المختار. |
onValueChange | (value: string) => void | لا يوجد | عند الاختيار. |
name | string | لا يوجد | اسم الحقل في النموذج. |
required / helperText / error / disabled / readOnly | … | لا يوجد | كما في حقل الإدخال؛ الخطأ يلوّن كل الدوائر. |
Radio
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value | string | لا يوجد | قيمة الخيار. مطلوبة. |
children | ReactNode | لا يوجد | خاصية Label: نص الخيار. |
description | ReactNode | لا يوجد | سطر مساعد. |
size | "sm" | "lg" | "sm" | Small (Web) أو Large (Native). |
disabled / readOnly | boolean | لا يوجد | لخيار واحد. |
إرشادات الاستخدام
أزرار الاختيار لاختيار واحد من قائمة قصيرة يجب أن يراها الناس كاملة. هنا: متى تختارها، وما القيمة الافتراضية، وكيف ترتب الخيارات وتسمّيها، وما تتحقق منه قبل التسليم.
1. أزرار الاختيار أم عنصر آخر
أزرار الاختيار تناسب اختيارًا واحدًا من قائمة قصيرة يجب أن يراها الناس كاملة. وهي تأخذ مساحة، وهذا هو الغرض: كل خيار ظاهر وقابل للمقارنة. وحين تطول القائمة، أو يُطبَّق التغيير فورًا، أو يكون السؤال نعم أو لا، فعنصر آخر أنسب.
| تحتاج إلى | استخدم | السبب |
|---|---|---|
| اختيار واحد من 2 إلى 5 في نموذج | أزرار الاختيار | كل خيار ظاهر وعلى بعد ضغطة واحدة. |
| اختيار واحد يحتاج إلى وصف أو سعر | بطاقة الاختيار الأحادي | مساحة للتفاصيل، والبطاقة كلها هدف الضغط. |
| اختيار واحد من خيارات كثيرة | القائمة المنسدلة | قائمة طويلة من أزرار الاختيار يصعب تصفحها. |
| تبديل عرض أو تصفية فورًا | مجموعة أزرار التبديل | يُطبَّق فورًا، دون إرسال. |
| الإجابة بنعم أو لا | مربع التفعيل أو مفتاح التبديل | زر الاختيار الوحيد لا يمكن إلغاؤه بعد اختياره. |
2. القيمة الافتراضية
بعد اختيار زر لا يستطيع الناس إلغاءه، بل يختارون غيره فقط. لذا اختر الحالة الأولى عن قصد. اختر مسبقًا الخيار الأكثر أمانًا أو شيوعًا حين يوجد، مثل التوصيل العادي. وحين تكون الإجابة شخصية أو تحتاج إلى قرار حقيقي، ابدأ دون اختيار واجعل الاختيار مطلوبًا.
قيمة افتراضية آمنة في مجموعة حقيقية
خيارات التوصيل عند الدفع.
افعل
- اختر مسبقًا قيمة آمنة شائعة: «التوصيل العادي»، «الفوترة الشهرية».
- اترك الأسئلة الشخصية فارغة واجعلها مطلوبة.
- أضف خيار «لا شيء» أو «ليس الآن» حين يكون التخطي إجابة صحيحة.
تجنّب
- اختيار ترقية مدفوعة أو الخطة الأغلى مسبقًا.
- استخدام زر اختيار واحد لنعم أو لا؛ لا يمكن إلغاؤه.
- تغيير القيمة الافتراضية بين الزيارات دون سبب.
3. الترتيب والصياغة
رتّب الخيارات كما يتوقع الناس: حسب الحجم أو الوقت أو السعر أو الشيوع، وأبجديًا فقط حين لا ينطبق غير ذلك. واجعل التسميات قصيرة ومتوازية، وضع التفاصيل في النص المساعد. و«أخرى» أو «لا شيء» في الآخر.
افعل
- رتّب حسب تسلسل طبيعي: من الأصغر إلى الأكبر، ومن الأرخص إلى الأغلى.
- اكتب تسميات متوازية: كلها أسماء، أو كلها عبارات قصيرة.
- ضع «أخرى» أو «لا شيء» في الآخر.
- رتّب الخيارات عموديًا، خيارًا في كل سطر.
تجنّب
- خلط جملة مع خيارات من كلمة واحدة.
- صفّ الأزرار أفقيًا حين تتفاوت أطوال التسميات.
- إخفاء فرق مهم، مثل السعر، في تلميح.
4. بطاقات الاختيار الأحادي
بطاقة الاختيار الأحادي صف قائمة أو بطاقة تُختار بزر اختيار، للخيارات التي تحتاج إلى أكثر من تسمية: الخطط، وطرق الشحن، والبطاقات المحفوظة. والبطاقة كلها هي التسمية. ويقع الزر عند نهاية السطر، أو في بدايته مع Leading type = Radio.
افعل
- استخدم البطاقات للخيارات التي يقارنها الناس بعدة تفاصيل.
- اجعل العنوان اسم الخيار، والتفاصيل في النص المساعد، والسعر نصًا في النهاية.
- اجعل بطاقات المجموعة بالارتفاع والتخطيط نفسيهما.
تجنّب
- خلط بطاقات الاختيار الأحادي وأزرار الاختيار العادية في مجموعة واحدة.
- وضع أزرار أو روابط داخل البطاقة.
5. العربية والاتجاه من اليمين إلى اليسار
في الشاشات العربية استخدم النسخ العربية: تقع الدائرة في بداية السطر (اليمين) وتمتد التسميات إلى يسارها. وفي الكود تتبع مفاتيح الأسهم ترتيب القراءة، فينقل ArrowLeft إلى الخيار التالي في العربية. ونقطة الاختيار لا تنعكس أبدًا.
الدائرة في بداية السطر
خيارات التوصيل بالعربية.
قبل التسليم
- أزرار الاختيار لخيارين إلى خمسة، والقائمة المنسدلة لما زاد.
- القيمة الافتراضية محسومة: خيار آمن، أو لا شيء مع جعله مطلوبًا.
- الخيارات مرتبة ومصاغة بتوازٍ.
- الشاشات العربية تستخدم النسخ العربية.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | يدخل المجموعة إلى الخيار المختار (أو الأول) ويخرج منها. |
| ArrowDownArrowRight | الخيار التالي ويختاره. في العربية ArrowLeft هو التالي. |
| ArrowUpArrowLeft | الخيار السابق ويختاره. |
ARIA
role="radiogroup"مسمّى بتسميته ومرتبط بنصه المساعد أو خطئه؛ كل خيارrole="radio"مسمّى بنصه.- لا تنفذ إجراءً عند الاختيار؛ انتظر الإرسال.
افعل
- سمِّ المجموعة، فالتسمية هي السؤال.
- Tab يدخل إلى الخيار المختار، والأسهم تتنقل وتختار.
- التسمية قابلة للنقر، والصف كله هدف اللمس.
- خطأ المجموعة تحت آخر خيار.
تجنّب
- تنفيذ إجراء أو الانتقال إلى صفحة عند الاختيار؛ انتظر الإرسال.
- الاكتفاء بالنقطة؛ التسمية هي ما يقول ما المختار.
ملاحظات العربية والاتجاه
ينعكس
- الدوائر في بداية الأسطر (اليمين)، والأسهم الأفقية تتبع اتجاه القراءة.
لا ينعكس
- النقطة داخل الدائرة متناظرة.
- الأرقام
- لا أرقام في الدائرة.
- الخط العربي
- الخيارات
label-16بوزن Medium، والوصفlabel-12.
افعل
- النسخة العربية لكل زر اختيار في نموذج عربي.
- اكتب الخيارات بالعربية أصلًا، والأسماء والأسعار بخطها.
تجنّب
- نص عربي في النسخة الإنجليزية.
- إبقاء ترتيب الخيارات الإنجليزي حين يتبع اتجاه القراءة، كمقياس من اليسار إلى اليمين.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.