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

أزرار الاختيار

احصل على Ritla UI

لاختيار خيار واحد فقط من قائمة قصيرة ظاهرة كلها؛ اختيار أحدها يلغي الباقي. الدائرة في بداية السطر.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add radio

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

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

    @base-ui/react

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

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

الاستخدام

radio.tsx
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" الدائرة الكبيرة للمس بهالتها.

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

مرجع الخصائص

RadioGroup

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدخاصية Label: اسم المجموعة.
value / defaultValuestring | nullلا يوجدالخيار المختار.
onValueChange(value: string) => voidلا يوجدعند الاختيار.
namestringلا يوجداسم الحقل في النموذج.
required / helperText / error / disabled / readOnly…لا يوجدكما في حقل الإدخال؛ الخطأ يلوّن كل الدوائر.

Radio

الخاصيةالنوعالافتراضيالوصف
valuestringلا يوجدقيمة الخيار. مطلوبة.
childrenReactNodeلا يوجدخاصية Label: نص الخيار.
descriptionReactNodeلا يوجدسطر مساعد.
size"sm" | "lg""sm"‏Small (Web) أو Large (Native).
disabled / readOnlybooleanلا يوجدلخيار واحد.

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

أزرار الاختيار لاختيار واحد من قائمة قصيرة يجب أن يراها الناس كاملة. هنا: متى تختارها، وما القيمة الافتراضية، وكيف ترتب الخيارات وتسمّيها، وما تتحقق منه قبل التسليم.

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.

افعل

  • النسخة العربية لكل زر اختيار في نموذج عربي.
  • اكتب الخيارات بالعربية أصلًا، والأسماء والأسعار بخطها.

تجنّب

  • نص عربي في النسخة الإنجليزية.
  • إبقاء ترتيب الخيارات الإنجليزي حين يتبع اتجاه القراءة، كمقياس من اليسار إلى اليمين.

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

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

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