القسم القابل للطي
لوحة واحدة تُظهر تفاصيل اختيارية أو تخفيها تحت عنوانها، مثل الرسوم. يبقى أهم سطر ظاهرًا، والباقي يُفتح تحته.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add collapsibleويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/collapsibleالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Collapsible, CollapsibleRow } from "@/components/ui/collapsible";<Collapsible title="Fees and exchange rate" summary={<CollapsibleRow label="Total fee">JOD 0.500</CollapsibleRow>}> <CollapsibleRow label="Transfer fee">JOD 0.500</CollapsibleRow> <CollapsibleRow label="Arrives">Today</CollapsibleRow></Collapsible>أمثلة
مفتوح ومتحكَّم فيه
open وonOpenChange للتحكم، هنا يبدأ مفتوحًا بلا سطر ملخص. استعمل الأكورديون إن كانت الأقسام عدة.
مرجع الخصائص
Collapsible
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
title | ReactNode | لا يوجد | خاصية Title: نص صف الزر. |
summary | ReactNode | لا يوجد | يبقى ظاهرًا تحت العنوان: أهم سطر. |
children | ReactNode | لا يوجد | التفاصيل التي تُفتح تحت الملخص، بفاصل 8 بكسل بين العناصر. |
defaultOpen | boolean | false | خاصية Open عند البداية. |
open / onOpenChange | boolean | لا يوجد | للتحكم في الفتح. |
disabled | boolean | false | يمنع الفتح والإغلاق. |
CollapsibleRow
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | ReactNode | لا يوجد | عنوان الصف في بدايته. |
children | ReactNode | لا يوجد | القيمة في نهاية الصف. نسّق المبالغ بـ formatNumber. |
إرشادات الاستخدام
القسم القابل للطي يُخفي كتلة واحدة من تفاصيل لا يحتاجها إلا بعض الناس، ويُبقي سطر الملخص ظاهرًا. هنا: الأكورديون أم القسم القابل للطي أم قسم الأسئلة الشائعة، وما تتسع له اللوحة، وما تتحقق منه قبل التسليم.
1. أكورديون أم قسم قابل للطي أم أسئلة شائعة
الأكورديون يُخفي تفاصيل لا يحتاجها إلا بعض الناس. وإن كان الجميع يحتاج إلى المحتوى فاعرضه. واختر الجزء حسب عدد اللوحات ومكانها.
| تحتاج إلى | استخدم | السبب |
|---|---|---|
| الإجابة عن أسئلة كثيرة في مكدّس، تُفتح واحدًا واحدًا | عنصر أكورديون | يمسح الناس الأسئلة ويفتحون سؤالهم فقط. |
| إخفاء كتلة واحدة من تفاصيل اختيارية، مثل الرسوم | قسم قابل للطي (هذه الصفحة) | لوحة واحدة بسطر ملخص يبقى ظاهرًا. |
| إضافة كتلة أسئلة شائعة كاملة إلى صفحة تسويقية | قسم الأسئلة الشائعة، أنواع الأكورديون | قسم جاهز بعنوان وأسئلة ورابط تواصل. |
| عرض خمسة أجوبة قصيرة أو أقل | قسم الأسئلة الشائعة، الأنواع البسيطة | الأجوبة القصيرة تُقرأ أسرع وهي مفتوحة كلها. |
| التبديل بين عروض متساوية الوزن | التبويبات | يظهر عرض واحد فقط، ولكل عرض اسم. |
2. ما تتسع له اللوحة
تحمل اللوحة جوابًا قصيرًا: فقرة، أو قائمة قصيرة، أو رابطًا إلى المزيد. وأبقِ المحتوى المطلوب وحقول النماذج خارج الأكورديون؛ فالناس يتخطون اللوحات المغلقة.
افعل
- ضع فقرة أو قائمة قصيرة أو رابطًا في اللوحة.
- اربط إلى مقال كامل حين يطول الجواب.
- استخدم الفاصل بين العناصر في المكدّس.
تجنّب
- أكورديون داخل أكورديون.
- إخفاء حقول نموذج مطلوبة أو شروط قانونية يجب أن يقرأها الناس.
- وضع الوسيلة الوحيدة لإنهاء مهمة داخل لوحة مغلقة.
قبل التسليم
- الأسئلة مكتوبة كما يسألها الناس.
- حالة الفتح الافتراضية معلَّمة، والروابط العميقة تفتح عنصرها.
- المحتوى الذي يحتاجه الجميع غير مخفي.
- المكدّسات العربية تستخدم النسخة العربية.
- الجوال يستخدم نقطة توقف الجوال.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| EnterSpace | يفتح اللوحة أو يغلقها. |
ARIA
- صف العنوان كله هو الزر، لا الأيقونة وحدها، وله
aria-expandedوaria-controls. - ارتفاع الصف 48 بكسل. الفتح والإغلاق في 200 ملّي ثانية، وفوريان مع تقليل الحركة.
- البحث في الصفحة يفتح اللوحة إن وجد النص فيها.
ملاحظات العربية والاتجاه
ينعكس
- العنوان على اليمين والسهم في نهاية الصف، أي على اليسار.
- في
CollapsibleRowالعنوان على اليمين والقيمة على اليسار.
لا ينعكس
- السهم المزدوج (أعلى وأسفل) لا ينعكس.
- الأرقام
- المبالغ تتبع إعداد الأرقام؛ نسّقها بـ
formatNumber. وسعر الصرف يُكتب بالترتيب العربي: 1 د.أ = 1.41 دولار. - الخط العربي
- العنوان
label-14Semibold، والارتفاعات حدود دنيا. - النص ثنائي الاتجاه
- القيم التي قد تأتي بأي لغة تأخذ
dir="auto".
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.