الخط الزمني
أحداث بترتيبها: تتبّع حوالة، وحالة طلب، ونشاط حساب، وسجل تدقيق. لكل عنصر مؤشر وخط وصل ومحتوى قصير.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add timelineويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/timelineالاعتماديات التي يضيفها
@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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. الأفقي لأربع خطوات أو أقل فقط، ويسير من اليمين إلى اليسار بالعربية.
نشاط الحساب
كل الأحداث منتهية، فكل العناصر مكتملة. سطر واحد لكل حدث، ورابط إلى السجل الكامل بدل النص الطويل.
مرجع الخصائص
Timeline
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
layout | "vertical" | "horizontal" | "auto" | "vertical" | خاصية Layout. auto عمودي على الجوال وأفقي من md. |
children | TimelineItem[] | لا يوجد | العناصر، الأقدم أولًا. |
TimelineItem
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
status | "complete" | "current" | "upcoming" | "complete" | خاصية Status. |
title | ReactNode | لا يوجد | خاصية Title: ما حدث، في سطر. |
time | ReactNode | لا يوجد | خاصية Show time: الوقت أو الحالة فوق العنوان. |
dateTime | string | لا يوجد | تاريخ ISO يجعل الوقت عنصر <time>. |
description | ReactNode | لا يوجد | خاصية Show description: سطر تفصيل أو رابط. |
connector | boolean | true | خاصية Show connector. العنصر الأخير بلا خط دائمًا. |
statusLabel | string | لا يوجد | الحالة لقارئ الشاشة. افتراضيًا: مكتمل، قيد التنفيذ، قادم، بلغة الصفحة. |
إرشادات الاستخدام
الخط الزمني يعرض أحداثًا مرتّبة بالوقت. هنا: عمودي أم أفقي، والحالات، وكيف يسير في العربية، وما تتحقق منه قبل التسليم.
1. عمودي أم أفقي
العمودي يناسب القوائم وصفحات التفاصيل؛ والأفقي يناسب مسارًا قصيرًا معروضًا في بطاقة، حتى خمسة عناصر.
افعل
- العمودي افتراضيًا.
- الأفقي فقط حين تتسع كل العناصر دون تمرير.
تجنّب
- تمرير خط زمني أفقي.
- التفاف العناصر الأفقية إلى صفّين.
2. الحالات
المكتمل ممتلئ، والحالي حلقة بلون العلامة، والقادم بإطار فقط. وعنصر واحد فقط هو الحالي.
افعل
- ضع الوقت على كل عنصر.
- لون الحالة على النقطة فقط.
تجنّب
- تلوين العنصر كله حسب الحالة.
- تعليم عنصر مستقبلي مكتملًا ليبدو منجزًا.
3. العربية والاتجاه من اليمين إلى اليسار
يُبقي الخط الزمني العمودي المسار عند بداية السطر؛ ويسير الأفقي من اليمين إلى اليسار. وتستخدم التواريخ أرقام التطبيق وتقويمه.
قبل التسليم
- التخطيطان في الاتجاهين.
- الحالات الثلاث موجودة.
- سلوك «عرض المزيد» محسوم للقوائم الطويلة.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى الروابط داخل العناصر فقط؛ الخط الزمني نفسه ليس عنصر تحكم. |
ARIA
- قائمة مرتبة (
ol)، فيقول قارئ الشاشة عدد الخطوات وموضع كل واحدة. - المؤشرات مخفية عنه، والحالة تُقال بكلمة قبل العنوان. الخطوة الحالية
aria-current="step". - الوقت مع
dateTimeعنصر<time>يُقرأ آليًا.
ملاحظات العربية والاتجاه
ينعكس
- الخط والمؤشرات على اليمين في العمودي.
- الأفقي يسير من اليمين إلى اليسار، والمسافة في نهاية المحتوى على اليسار.
لا ينعكس
- علامة الصح لا تنعكس.
- المراجع والأرقام والهواتف تبقى من اليسار إلى اليمين (
<bdi dir="ltr">).
- الأرقام
- الأوقات والأرقام تتبع إعداد الأرقام:
toNumeralsللنصوص الثابتة وformatNumberللمبالغ. - الخط العربي
- الوقت
label-12، والعنوانlabel-14Semibold، والتفصيلlabel-14. - النص ثنائي الاتجاه
- كل سطر
dir="auto"، فيبدأ السطر العربي بكلمة عربية كما تقول Figma، والمرجع اللاتيني لا يقلب الجملة.
افعل
- النسخة العربية للتخطيطين.
- اعرض التواريخ الهجرية حيث يستخدمها المنتج.
تجنّب
- عكس أيقونات الحالة.
- الجمع بين تقويمين في خط زمني واحد.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.