قائمة

List

مكوّن قائمة في React للقوائم النقطية والمرقّمة والأيقونية بإيقاع متّسق وتداخل ودرجات وترقيم أبجدي عربي في الاتجاه من اليمين.

يعرض List قوائم نقطية أو مرقمة أو بأيقونات بالعنصر الصحيح <ul>/<ol>. يدعم ListItem مستوى ثانيًا من التداخل وأيقونة خاصة لكل عنصر.

متى تستخدمه

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

للصفوف التفاعلية، استخدم StructuredList.

أمثلة

الأنماط

مستويات التداخل والدرجة

مع أيقونة مخصّصة

العربية (RTL)

الخصائص

الخصائص التي يعرّفها List. سمات العنصر الأصلي تمرّ كما هي.

<List>

الخاصيةالنوعالافتراضيالوصف
variant"ordered" | "unordered" | "with-icon"
tone"primary" | "neutral" | "on-color"

<ListItem>

الخاصيةالنوعالافتراضيالوصف
level1 | 2Nesting depth: 2 indents 24px and shifts the marker (ordered → letters, unordered → bullet).
iconreact.ReactNodewith-icon lists only - overrides the default check-circle for this item.

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

يعرض List عنصر <ul> أو <ol> الأصلي، فيُعلن عدد العناصر ومواضعها. الأيقونات aria-hidden، ونص العنصر يحمل المعنى.

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