التبويبات
تنقّل بين عروض متكافئة للمحتوى نفسه دون مغادرة الصفحة؛ تبويب واحد ظاهر في كل مرة.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add tabsويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/tabsالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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>أمثلة
عمودية
عمود للإعدادات على الشاشات العريضة، يتحول إلى صف أفقي قابل للتمرير على الهاتف.
أيقونات وشارات
أيقونة على كل التبويبات أو لا شيء، وعدد بعد التسمية.
المقاسات
breakpoint يثبّت مقاس سطح المكتب (16) أو الهاتف (14)؛ الافتراضي auto يتبع الشاشة.
اللون المحايد
tone="neutral" تحديد رمادي للأسطح الهادئة. تبويب الزر المحدد يأخذ حلقة رفيعة بلون border/gray/strong ليبقى ظاهرًا بتباين 3:1، والخط السفلي يبقى بلون العلامة.
مرجع الخصائص
Tabs
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
type | "underline" | "button" | "underline" | خاصية Type: خط سفلي تحت المحدد، أو تعبئة عليه. |
orientation | "horizontal" | "vertical" | "horizontal" | Horizontal tabs أو Vertical tabs في Figma. |
breakpoint | "auto" | "desktop" | "mobile" | "auto" | خاصية Breakpoint. auto مقاس الهاتف تحت md وسطح المكتب من md، وفيه تصبح العمودية صفًا على الهاتف. |
dividers | boolean | true | خاصية Show line divider: خطوط بين تبويبات الزر الأفقية. |
tone | "brand" | "neutral" | "brand" | خاصية Tone: تحديد بلون العلامة أو رمادي. |
value / defaultValue | string | لا يوجد | التبويب المحدد (متحكَّم به أو أولي). |
onValueChange | (value) => void | لا يوجد | يُستدعى عند اختيار تبويب. |
TabsList
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
aria-label | string | لا يوجد | اسم مجموعة التبويبات لقارئ الشاشة. |
activateOnFocus | boolean | true | يختار التبويب بمجرد وصول الأسهم إليه. أوقفه إذا كان تحميل اللوحة بطيئًا. |
Tab
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value | string | لا يوجد | يطابق value في لوحته. |
children | ReactNode | لا يوجد | خاصية Label: كلمة أو كلمتان على سطر واحد. |
iconLeading | IconComponent | لا يوجد | خاصيتا Icon وLeading icon. |
badge | number | string | لا يوجد | خاصية Badge وعددها: شارة Brand بعد التسمية. |
disabled | boolean | false | ليست في Figma: تبويب لا يمكن اختياره بعد. |
TabsPanel
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value | string | لا يوجد | يطابق 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>.
افعل
- النسخة العربية، وأول تبويب على اليمين.
- الترتيب نفسه كما في الإنجليزية، يسير من اليمين إلى اليسار.
- تحقّق من أن أطول تسمية عربية تتسع في سطر واحد.
تجنّب
- تبويبات إنجليزية في شاشة عربية.
- عكس الترتيب يدويًا في النسخة الإنجليزية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.