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

الخط الزمني

احصل على Ritla UI

أحداث بترتيبها: تتبّع حوالة، وحالة طلب، ونشاط حساب، وسجل تدقيق. لكل عنصر مؤشر وخط وصل ومحتوى قصير.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add timeline

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

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

    @phosphor-icons/react

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

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

الاستخدام

timeline.tsx
import { Timeline, TimelineItem } from "@/components/ui/timeline";<Timeline>  <TimelineItem time="24 Sep, 10:42" title="Transfer submitted" description="Reference FT26270X482" />  <TimelineItem status="current" time="In progress" title="Sent to beneficiary bank" />  <TimelineItem status="upcoming" time="Expected by 11:45" title="Credited to account" /></Timeline>

أمثلة

أفقي على الشاشات العريضة

‏layout="auto": عمودي على الجوال وأفقي من md. الأفقي لأربع خطوات أو أقل فقط، ويسير من اليمين إلى اليسار بالعربية.

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

نشاط الحساب

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

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

مرجع الخصائص

Timeline

الخاصيةالنوعالافتراضيالوصف
layout"vertical" | "horizontal" | "auto""vertical"خاصية Layout. ‏auto عمودي على الجوال وأفقي من md.
childrenTimelineItem[]لا يوجدالعناصر، الأقدم أولًا.

TimelineItem

الخاصيةالنوعالافتراضيالوصف
status"complete" | "current" | "upcoming""complete"خاصية Status.
titleReactNodeلا يوجدخاصية Title: ما حدث، في سطر.
timeReactNodeلا يوجدخاصية Show time: الوقت أو الحالة فوق العنوان.
dateTimestringلا يوجدتاريخ ISO يجعل الوقت عنصر <time>.
descriptionReactNodeلا يوجدخاصية Show description: سطر تفصيل أو رابط.
connectorbooleantrueخاصية Show connector. العنصر الأخير بلا خط دائمًا.
statusLabelstringلا يوجدالحالة لقارئ الشاشة. افتراضيًا: مكتمل، قيد التنفيذ، قادم، بلغة الصفحة.

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

الخط الزمني يعرض أحداثًا مرتّبة بالوقت. هنا: عمودي أم أفقي، والحالات، وكيف يسير في العربية، وما تتحقق منه قبل التسليم.

1. عمودي أم أفقي

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

افعل

  • العمودي افتراضيًا.
  • الأفقي فقط حين تتسع كل العناصر دون تمرير.

تجنّب

  • تمرير خط زمني أفقي.
  • التفاف العناصر الأفقية إلى صفّين.

2. الحالات

المكتمل ممتلئ، والحالي حلقة بلون العلامة، والقادم بإطار فقط. وعنصر واحد فقط هو الحالي.

افعل

  • ضع الوقت على كل عنصر.
  • لون الحالة على النقطة فقط.

تجنّب

  • تلوين العنصر كله حسب الحالة.
  • تعليم عنصر مستقبلي مكتملًا ليبدو منجزًا.

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

يُبقي الخط الزمني العمودي المسار عند بداية السطر؛ ويسير الأفقي من اليمين إلى اليسار. وتستخدم التواريخ أرقام التطبيق وتقويمه.

قبل التسليم

  • التخطيطان في الاتجاهين.
  • الحالات الثلاث موجودة.
  • سلوك «عرض المزيد» محسوم للقوائم الطويلة.

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

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

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

المفتاحما يفعله
Tabإلى الروابط داخل العناصر فقط؛ الخط الزمني نفسه ليس عنصر تحكم.

ARIA

  • قائمة مرتبة (ol)، فيقول قارئ الشاشة عدد الخطوات وموضع كل واحدة.
  • المؤشرات مخفية عنه، والحالة تُقال بكلمة قبل العنوان. الخطوة الحالية aria-current="step".
  • الوقت مع dateTime عنصر <time> يُقرأ آليًا.

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

ينعكس

  • الخط والمؤشرات على اليمين في العمودي.
  • الأفقي يسير من اليمين إلى اليسار، والمسافة في نهاية المحتوى على اليسار.

لا ينعكس

  • علامة الصح لا تنعكس.
  • المراجع والأرقام والهواتف تبقى من اليسار إلى اليمين (<bdi dir="ltr">).
الأرقام
الأوقات والأرقام تتبع إعداد الأرقام: toNumerals للنصوص الثابتة وformatNumber للمبالغ.
الخط العربي
الوقت label-12، والعنوان label-14 Semibold، والتفصيل label-14.
النص ثنائي الاتجاه
كل سطر dir="auto"، فيبدأ السطر العربي بكلمة عربية كما تقول Figma، والمرجع اللاتيني لا يقلب الجملة.

افعل

  • النسخة العربية للتخطيطين.
  • اعرض التواريخ الهجرية حيث يستخدمها المنتج.

تجنّب

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

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

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

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