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

مبدّل المحتوى

احصل على Ritla UI

يبدّل فورًا بين خيارين إلى أربعة عروض أو مرشّحات للمحتوى نفسه، مثل يوم وأسبوع وشهر (وحتى ست فترات بشكل الكبسولات)؛ خيار واحد محدد دائمًا.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add content-switcher

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

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

    @base-ui/react

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

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

الاستخدام

content-switcher.tsx
import { ContentSwitcher, ContentSwitcherItem } from "@/components/ui/content-switcher";<ContentSwitcher aria-label="Period" defaultValue="day">  <ContentSwitcherItem value="day">Day</ContentSwitcherItem>  <ContentSwitcherItem value="week">Week</ContentSwitcherItem>  <ContentSwitcherItem value="month">Month</ContentSwitcherItem></ContentSwitcher>

أمثلة

المقاسات

‏sm بارتفاع 32 (الافتراضي)، وmd بارتفاع 40، وlg بارتفاع 48.

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

عدّادات وأيقونات

عدد بعد التسمية، أو أيقونات وحدها مع إبقاء التسمية لقارئ الشاشة (showLabel={false}).

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

معطّل

خيار غير متاح بعد، ثم المبدّل كله.

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

اللون المحايد

‏tone="neutral" يلوّن الخيار المحدد بلون السطح المعكوس، حين ينافس لون العلامة الإجراء الرئيسي في الصفحة.

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

الكبسولات

‏variant="pill-segmented" مسار رمادي فيه خيار مرتفع، وvariant="pills" كبسولات منفصلة. بالمقاس الصغير واللون المحايد فقط كما في Figma، وحتى ست فترات. اكتب الفترات بالعربية كلمات لا اختصارات لاتينية، ويمرَّر الصف جانبيًا إن لم يتسع.

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

مرجع الخصائص

ContentSwitcher

الخاصيةالنوعالافتراضيالوصف
size"sm" | "md" | "lg""sm"خاصية Size: ‏32 أو 40 أو 48 بكسل.
value / defaultValuestringلا يوجدالخيار المحدد (متحكَّم به أو أولي). في Figma يُحدَّد الأول.
onValueChange(value: string) => voidلا يوجديُستدعى عند اختيار خيار.
dividersbooleantrueخاصية Divider: خطوط بين الخيارات غير المحددة (الشكل الافتراضي فقط).
tone"brand" | "neutral""brand"خاصية Tone. الكبسولات محايدة دائمًا.
variant"default" | "pill-segmented" | "pills""default"خاصية Style. الكبسولات بالمقاس الصغير، فلا يُطبَّق size عليها.
disabledbooleanfalseيعطّل كل الخيارات.
aria-labelstringلا يوجداسم الاختيار لقارئ الشاشة («الفترة»).

ContentSwitcherItem

الخاصيةالنوعالافتراضيالوصف
valuestringلا يوجدقيمة الخيار في المبدّل.
childrenReactNodeلا يوجدخاصية Label: كلمة واحدة قصيرة، وهي اسم الخيار حتى مع إخفائها.
showLabelbooleantrueخاصية Show label. عند إيقافها تبقى الأيقونة وحدها.
iconLeadingIconComponentلا يوجدخاصية Icon: أيقونة 16 بكسل بلون التسمية.
badgenumber | stringلا يوجدخاصية Badge وعددها: رمادية، وBrand على الخيار المحدد.
disabledbooleanfalse‏State = Disabled لهذا الخيار.

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

مبدّل المحتوى يغيّر طريقة عرض المحتوى الذي تحته مباشرة. هنا: متى تختاره، وكيف تكتب خياراته، وأي مقاس، وكيف يبدأ من اليمين في العربية، وما تتحقق منه قبل التسليم.

1. مبدّل المحتوى أم غيره

استخدم مبدّل المحتوى لتغيير طريقة عرض المحتوى الذي تحته مباشرة: رسم بياني حسب الفترة، أو قائمة حسب الحالة، أو خريطة أو قائمة. ويُطبَّق فورًا. واستخدمه داخل البطاقات والرسوم البيانية واللوحات، ومجموعة أزرار التبديل في أشرطة الأدوات بجوار الأزرار.

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

2. الخيارات والتسميات

من خيارين إلى أربعة، كلمة قصيرة لكل منها، بأطوال متقاربة لتبدو الأجزاء متساوية. والخيار الأول مختار افتراضيًا. والأيقونات اختيارية: على كل خيار أو على لا شيء. والخيارات ذات الأيقونة وحدها تحتفظ بتسميتها اسمًا لقارئات الشاشة.

خيارات قصيرة ومتساوية

مبدّل الفترة فوق رسم بياني للإنفاق.

افعل: كلمة لكل خيارأربعة أجزاء متساوية تُقرأ بنظرة.
تجنّب: تسميات غير متساوية«آخر 7 أيام» يمطّ جزءه فيبدو الصف مكسورًا.

افعل

  • كلمة واحدة لكل خيار: «يوم»، «أسبوع»، «شهر»، «سنة».
  • أبقِ التسميات بأطوال متقاربة.
  • اجعل الخيار الأنفع أولًا ومختارًا.

تجنّب

  • أكثر من أربعة خيارات.
  • عبارة طويلة بين خيارات من كلمة واحدة.
  • أيقونات على بعض الخيارات دون غيرها.

3. المقاس

المقاس sm (32) يناسب داخل البطاقات ورؤوس الرسوم البيانية، وmd (40) هو الافتراضي، وlg (48) يناسب الشاشات التي يكثر فيها اللمس. ويضيف sm وmd منطقة لمس غير مرئية بارتفاع 48 بكسل في الكود. طابِق ارتفاع العناصر المجاورة.

افعل

  • استخدم sm في رؤوس البطاقات والرسوم البيانية.
  • طابِق مقاس العناصر المجاورة.

تجنّب

  • استخدام lg في رأس بطاقة كثيف.
  • مدّ المبدّل إلى العرض الكامل على الحاسوب.

4. العربية والاتجاه من اليمين إلى اليسار

تبدأ النسخة العربية من اليمين: الخيار الأول، المختار افتراضيًا، على اليمين، والأطراف المستديرة تتبع اتجاه القراءة. وتتبعه مفاتيح الأسهم أيضًا، فينتقل السهم الأيسر إلى الخيار التالي في العربية. وأبقِ ترتيب الخيارات كما في الإنجليزية.

الخيار الأول على اليمين

مبدّل الفترة بالعربية.

افعل: النسخة العربية«يوم» أولًا ومختار، على اليمين حيث يبدأ القارئ العربي.
تجنّب: المبدّل الإنجليزي في شاشة عربيةالخيار الأول على اليسار، والتسميات بخطوط لاتينية.

قبل التسليم

  • من 2 إلى 4 خيارات تغيّر المحتوى الذي تحتها مباشرة.
  • تسميات من كلمة بأطوال متقاربة؛ والأول مختار.
  • المقاس يطابق ما يجاوره.
  • الشاشات العربية تستخدم النسخة العربية.

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

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

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

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

ARIA

  • ‏role="radiogroup" باسم من aria-label، وكل خيار role="radio" مع aria-checked.
  • التحديد لا يعتمد على اللون وحده: الخيار المحدد ممتلئ بلون العلامة، والبقية بإطار.
  • في الكبسولات المجزأة يأخذ الخيار المحدد حلقة border/gray/strong رفيعة، لأن سطحه الأبيض 1.16:1 فقط أمام المسار.
  • للتنقل بين الصفحات استخدم التبويبات، وللإعدادات التي تُحفظ استخدم أزرار الاختيار.

افعل

  • سمِّ المبدّل: «الفترة».
  • Tab يدخل على الخيار المختار، والأسهم تنقل الاختيار وتتبع اتجاه القراءة.
  • تسمية لكل خيار، حتى لو ظهرت أيقونته وحدها.

تجنّب

  • استخدامه للانتقال إلى صفحات أخرى.
  • الاعتماد على لون التعبئة وحده؛ فالخيار المختار له تسمية أقوى أيضًا.

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

ينعكس

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

لا ينعكس

  • أيقونات الرسوم البيانية والجداول تبقى كما هي.
الأرقام
عدد الشارة يتبع إعداد الأرقام.
الخط العربي
‏label-14 بوزن Medium بخط العرض، وارتفاع أدنى لا ثابت لأن أسطر العربية أطول.
النص ثنائي الاتجاه
التسميات لا تنكسر على سطرين؛ اجعلها كلمة واحدة بطول متقارب.

افعل

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

تجنّب

  • المبدّل الإنجليزي في شاشة عربية.
  • عكس الخيارات يدويًا في النسخة الإنجليزية.

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

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

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