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

مجموعة أزرار التبديل

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add toggle-group

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

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

    @base-ui/react@phosphor-icons/react

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

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

الاستخدام

toggle-group.tsx
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";<ToggleGroup aria-label="Period" defaultValue="week">  <ToggleGroupItem value="day" label="Day" />  <ToggleGroupItem value="week" label="Week" />  <ToggleGroupItem value="month" label="Month" /></ToggleGroup>

أمثلة

الأنماط

outline (الافتراضي) وtonal وfilled. الخيار المختار يأخذ لون الزر المضغوط، والفواصل والإطار بلون واحد. الخيار المعطّل يبقى ظاهرًا.

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

الأحجام

بارتفاعات الزر: ‏56 و48 و40 و32 بكسل. مساحة النقر 48 بكسل على الأقل في sm وxs.

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

أيقونات فقط

showLabel={false} يُبقي الأيقونة وحدها لأشرطة الأدوات المدمجة، ويبقى label اسمًا لقارئات الشاشة.

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

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

نسخة متحكَّم بها عبر value وonValueChange، والأعداد تتبع إعداد الأرقام. Tab يدخل المجموعة مرة واحدة، والأسهم تنتقل بين الخيارات: في العربية السهم الأيسر هو التالي.

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

مرجع الخصائص

ToggleGroup

الخاصيةالنوعالافتراضيالوصف
variant"outline" | "tonal" | "filled""outline"خاصية Style.
size"lg" | "md" | "sm" | "xs""lg"خاصية Size: ‏56 و48 و40 و32 بكسل.
valuestringلا يوجدقيمة الخيار المختار (متحكَّم به).
defaultValuestringلا يوجدالخيار المختار في البداية. في Figma هو الأول.
onValueChange(value: string) => voidلا يوجديُستدعى بالقيمة الجديدة. الضغط على المختار مجددًا لا يلغي اختياره.
disabledbooleanfalseيعطّل كل الخيارات.
aria-labelstringلا يوجداسم المجموعة («الفترة»، «طريقة العرض»).

ToggleGroupItem

الخاصيةالنوعالافتراضيالوصف
valuestringلا يوجدمعرّف الخيار.
labelstringلا يوجدمطلوب. خاصية Label، واسم الخيار حتى لو أُخفي النص.
showLabelbooleantrueخاصية Show Label.
iconLeadingIconComponentلا يوجدIcon leading: أيقونة قبل النص.
disabledbooleanfalseState = Disabled لهذا الخيار.

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

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

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

المفتاحما يفعله
Tabيدخل المجموعة مرة واحدة، على الخيار المختار، ويخرج منها بالضغطة التالية.
ArrowRightArrowLeftينتقل إلى الخيار التالي أو السابق ويلتف عند الطرفين. في العربية ينعكس الاتجاه.
EnterSpaceيختار الخيار الذي عليه التركيز.

ARIA

  • مجموعة role="group" باسم من aria-label، وكل خيار زر أصلي يحمل aria-pressed.
  • الاختيار لا يعتمد على اللون وحده: يعلنه aria-pressed، ويبقى خيار واحد مختارًا دائمًا.
  • في وضع الأيقونات فقط يصبح label قيمة aria-label للخيار.

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

ينعكس

  • ترتيب الخيارات ينعكس: الأول في بداية السطر (اليمين في العربية)، والفواصل حدود منطقية تتبع الاتجاه.
  • الأسهم تتبع اتجاه القراءة: السهم الأيسر ينتقل إلى الخيار التالي في العربية.

لا ينعكس

  • الأيقونات غير الاتجاهية (قائمة، شبكة، خريطة) لا تنعكس؛ الاتجاهية فقط تنعكس عبر <Icon>.
الأرقام
الأعداد داخل الخيارات («مفتوحة 12») تُنسّق بـformatNumber وتتبع إعداد الأرقام.
الخط العربي
body-16 (وbody-14 في xs) بوزن Semibold كالزر. الخيارات تأخذ عرض نصها، فالعربية الأقصر لا تُمدّ.
النص ثنائي الاتجاه
اسم لاتيني داخل خيار عربي («عرض Kanban») يُعرض صحيحًا في نهاية النص؛ في وسطه ضعه في <bdi>.

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

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

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