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

القسم القابل للطي

احصل على Ritla UI

لوحة واحدة تُظهر تفاصيل اختيارية أو تخفيها تحت عنوانها، مثل الرسوم. يبقى أهم سطر ظاهرًا، والباقي يُفتح تحته.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add collapsible

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

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

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

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

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

الاستخدام

collapsible.tsx
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 للتحكم، هنا يبدأ مفتوحًا بلا سطر ملخص. استعمل الأكورديون إن كانت الأقسام عدة.

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

مرجع الخصائص

Collapsible

الخاصيةالنوعالافتراضيالوصف
titleReactNodeلا يوجدخاصية Title: نص صف الزر.
summaryReactNodeلا يوجديبقى ظاهرًا تحت العنوان: أهم سطر.
childrenReactNodeلا يوجدالتفاصيل التي تُفتح تحت الملخص، بفاصل 8 بكسل بين العناصر.
defaultOpenbooleanfalseخاصية Open عند البداية.
open / onOpenChangebooleanلا يوجدللتحكم في الفتح.
disabledbooleanfalseيمنع الفتح والإغلاق.

CollapsibleRow

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدعنوان الصف في بدايته.
childrenReactNodeلا يوجدالقيمة في نهاية الصف. نسّق المبالغ بـ formatNumber.

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

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

1. أكورديون أم قسم قابل للطي أم أسئلة شائعة

الأكورديون يُخفي تفاصيل لا يحتاجها إلا بعض الناس. وإن كان الجميع يحتاج إلى المحتوى فاعرضه. واختر الجزء حسب عدد اللوحات ومكانها.

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

2. ما تتسع له اللوحة

تحمل اللوحة جوابًا قصيرًا: فقرة، أو قائمة قصيرة، أو رابطًا إلى المزيد. وأبقِ المحتوى المطلوب وحقول النماذج خارج الأكورديون؛ فالناس يتخطون اللوحات المغلقة.

افعل

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

تجنّب

  • أكورديون داخل أكورديون.
  • إخفاء حقول نموذج مطلوبة أو شروط قانونية يجب أن يقرأها الناس.
  • وضع الوسيلة الوحيدة لإنهاء مهمة داخل لوحة مغلقة.

قبل التسليم

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

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

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

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

المفتاحما يفعله
EnterSpaceيفتح اللوحة أو يغلقها.

ARIA

  • صف العنوان كله هو الزر، لا الأيقونة وحدها، وله aria-expanded وaria-controls.
  • ارتفاع الصف 48 بكسل. الفتح والإغلاق في 200 ملّي ثانية، وفوريان مع تقليل الحركة.
  • البحث في الصفحة يفتح اللوحة إن وجد النص فيها.

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

ينعكس

  • العنوان على اليمين والسهم في نهاية الصف، أي على اليسار.
  • في CollapsibleRow العنوان على اليمين والقيمة على اليسار.

لا ينعكس

  • السهم المزدوج (أعلى وأسفل) لا ينعكس.
الأرقام
المبالغ تتبع إعداد الأرقام؛ نسّقها بـ formatNumber. وسعر الصرف يُكتب بالترتيب العربي: 1 د.أ = 1.41 دولار.
الخط العربي
العنوان label-14 Semibold، والارتفاعات حدود دنيا.
النص ثنائي الاتجاه
القيم التي قد تأتي بأي لغة تأخذ dir="auto".

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

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

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