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

التبويبات

احصل على Ritla UI

تنقّل بين عروض متكافئة للمحتوى نفسه دون مغادرة الصفحة؛ تبويب واحد ظاهر في كل مرة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add tabs

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

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

    @base-ui/react

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

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

الاستخدام

tabs.tsx
import { Tab, Tabs, TabsList, TabsPanel } from "@/components/ui/tabs";<Tabs defaultValue="overview">  <TabsList aria-label="Account">    <Tab value="overview">Overview</Tab>    <Tab value="transactions">Transactions</Tab>  </TabsList>  <TabsPanel value="overview">…</TabsPanel>  <TabsPanel value="transactions">…</TabsPanel></Tabs>

أمثلة

نوع الزر

تعبئة على التبويب المحدد وخطوط فاصلة بين البقية؛ يناسب أشرطة الأدوات المدمجة.

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

عمودية

عمود للإعدادات على الشاشات العريضة، يتحول إلى صف أفقي قابل للتمرير على الهاتف.

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

أيقونات وشارات

أيقونة على كل التبويبات أو لا شيء، وعدد بعد التسمية.

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

المقاسات

‏breakpoint يثبّت مقاس سطح المكتب (16) أو الهاتف (14)؛ الافتراضي auto يتبع الشاشة.

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

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

‏tone="neutral" تحديد رمادي للأسطح الهادئة. تبويب الزر المحدد يأخذ حلقة رفيعة بلون border/gray/strong ليبقى ظاهرًا بتباين 3:1، والخط السفلي يبقى بلون العلامة.

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

مرجع الخصائص

Tabs

الخاصيةالنوعالافتراضيالوصف
type"underline" | "button""underline"خاصية Type: خط سفلي تحت المحدد، أو تعبئة عليه.
orientation"horizontal" | "vertical""horizontal"‏Horizontal tabs أو Vertical tabs في Figma.
breakpoint"auto" | "desktop" | "mobile""auto"خاصية Breakpoint. ‏auto مقاس الهاتف تحت md وسطح المكتب من md، وفيه تصبح العمودية صفًا على الهاتف.
dividersbooleantrueخاصية Show line divider: خطوط بين تبويبات الزر الأفقية.
tone"brand" | "neutral""brand"خاصية Tone: تحديد بلون العلامة أو رمادي.
value / defaultValuestringلا يوجدالتبويب المحدد (متحكَّم به أو أولي).
onValueChange(value) => voidلا يوجديُستدعى عند اختيار تبويب.

TabsList

الخاصيةالنوعالافتراضيالوصف
aria-labelstringلا يوجداسم مجموعة التبويبات لقارئ الشاشة.
activateOnFocusbooleantrueيختار التبويب بمجرد وصول الأسهم إليه. أوقفه إذا كان تحميل اللوحة بطيئًا.

Tab

الخاصيةالنوعالافتراضيالوصف
valuestringلا يوجديطابق value في لوحته.
childrenReactNodeلا يوجدخاصية Label: كلمة أو كلمتان على سطر واحد.
iconLeadingIconComponentلا يوجدخاصيتا Icon وLeading icon.
badgenumber | stringلا يوجدخاصية Badge وعددها: شارة Brand بعد التسمية.
disabledbooleanfalseليست في Figma: تبويب لا يمكن اختياره بعد.

TabsPanel

الخاصيةالنوعالافتراضيالوصف
valuestringلا يوجديطابق value في تبويبه؛ تُخفى اللوحة ما لم يكن تبويبها محددًا.

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

التبويبات تعرض عروضًا متكافئة لموضوع واحد، عرضًا في كل مرة. هنا: متى تناسب، وأي نوع واتجاه، وكيف تكتب التسميات، وما تفعله حين تكثر، وكيف تبدأ من اليمين في العربية، وما تتحقق منه قبل التسليم.

1. تبويبات أم بنية أخرى

تناسب التبويبات موضوعًا واحدًا له بضعة عروض متكافئة ينظر الناس إلى واحد منها في كل مرة: «نظرة عامة» و«المعاملات» و«الكشوف» لحساب. وإن كانت العروض خطوات أو أماكن أو مرشّحات، فمكوّن آخر يعبّر عنها أفضل.

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

2. النوع والاتجاه

تبويبات الخط السفلي تقع أعلى الصفحة أو البطاقة وتُقرأ أقسامًا لها. وتبويبات الأزرار شريط مدمج لأشرطة الأدوات واللوحات. والتبويبات العمودية تحمل أقسامًا كثيرة بجوار المحتوى على الحاسوب، وتصبح صفًا أفقيًا على الهواتف. ونقطة التوقف تحدد المقاس؛ وفي الكود تتبع القيمة auto الشاشة.

النوعالاستخدام
خط سفليأقسام صفحة أو بطاقة؛ الافتراضي.
أزرارأشرطة مدمجة في أشرطة الأدوات واللوحات والتخطيطات الكثيفة.

افعل

  • استخدم الخط السفلي لأقسام الصفحة، والأزرار للأشرطة المدمجة.
  • استخدم التبويبات العمودية لإعدادات كثيرة الأقسام على الحاسوب.
  • نوع واحد في كل صفحة.

تجنّب

  • تكديس صفّين من التبويبات.
  • الجمع بين الخط السفلي والأزرار في شاشة واحدة.

3. التسميات والأيقونات

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

أيقونات على كل التبويبات أو على لا شيء

صفحة حساب.

افعل: تسميات فقطلكل تبويب الأجزاء نفسها؛ فيُقرأ الصف متوازنًا.
تجنّب: أيقونات على بعض التبويباتيبدو التبويبان ذوا الأيقونة أهم من البقية.

افعل

  • سمِّ كل عرض بكلمة أو كلمتين.
  • ضع الأيقونات على كل التبويبات أو على لا شيء.
  • أبقِ ترتيب التبويبات نفسه في كل تحميل للصفحة.
  • استخدم شارة لعدد داخل التبويب: «الطلبات 3».

تجنّب

  • تسمية تلتف إلى سطرين.
  • أيقونة على بعض التبويبات دون غيرها.
  • أفعال أو جمل تسمياتٍ للتبويبات.

4. تبويبات كثيرة

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

افعل

  • قرابة خمسة تبويبات في الشريط الأفقي.
  • دع الشريط يتمرّر أفقيًا عند الحاجة، والتبويب المختار ظاهر.
  • انتقل إلى التبويبات العمودية للقوائم الطويلة على الحاسوب.

تجنّب

  • تصغير التسميات أو قصّها لتتسع تبويبات أكثر.
  • إخفاء تبويبات خلف تبويب «المزيد».
  • التفاف التبويبات إلى صفّين.

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

تبدأ النسخ العربية من اليمين: التبويب الأول على الحافة اليمنى والترتيب يسير نحو اليسار. وتتبع مفاتيح الأسهم اتجاه القراءة، فينتقل السهم الأيسر إلى التبويب التالي في العربية. وتضع التبويبات العمودية القائمة ومؤشرها على اليمين. والتسميات العربية أطول غالبًا؛ تحقّق من بقائها في سطر واحد.

التبويبات تبدأ من اليمين

صفحة حساب بالعربية.

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

قبل التسليم

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

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

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

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

المفتاحما يفعله
Tabيدخل القائمة على التبويب المحدد، والضغطة التالية تنتقل إلى اللوحة.
ArrowRightArrowLeftينتقل إلى التبويب التالي أو السابق ويختاره، ويلتف عند الطرفين. في العربية ينعكس الاتجاه؛ في العمودية ArrowDown وArrowUp.
HomeEndإلى أول تبويب أو آخره.

ARIA

  • ‏role="tablist" باسم من aria-label، وكل تبويب role="tab" مع aria-selected ومرتبط بلوحته role="tabpanel".
  • الأيقونة زخرفية، والعدد في الشارة جزء من اسم التبويب.
  • في اللون المحايد، تعبئة Figma الرمادية 1.16:1 فقط أمام الشريط، فيأخذ التبويب المحدد حلقة border/gray/strong رفيعة تبلغ 3:1.
  • للتنقل بين صفحات أو خطوات استخدم الروابط أو مؤشر الخطوات، لا التبويبات.

افعل

  • سمِّ قائمة التبويبات: «الحساب».
  • Tab يدخل إلى التبويب المختار، والأسهم تتنقل، وHome وEnd إلى الطرفين.
  • اختر بالأسهم حين تظهر اللوحات فورًا، وإلا فبـEnter أو Space.
  • علّم التبويب المختار بأكثر من اللون: خط أو حبة.

تجنّب

  • جعل كل تبويب محطة Tab مستقلة.
  • فتح صفحة جديدة عند الضغط على تبويب.

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

ينعكس

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

لا ينعكس

  • الأيقونات الزخرفية تبقى كما هي، إلا أيقونات الاتجاه في قائمة الانعكاس.
الأرقام
عدد الشارة يتبع إعداد الأرقام (0123456789 أو ٠١٢٣٤٥٦٧٨٩).
الخط العربي
‏body-16 أو body-14 بوزن Semibold، وارتفاع أدنى لا ثابت لأن أسطر العربية أطول.
النص ثنائي الاتجاه
تسمية التبويب لا تنكسر على سطرين. اسم علامة إنجليزي داخل تسمية عربية يوضع في <bdi>.

افعل

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

تجنّب

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

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

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

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