الحالة الفارغة
تملأ مساحة لا محتوى فيها بعد، وتقول السبب، وتدل على الخطوة التالية.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add emptyويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/emptyأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Empty } from "@/components/ui/empty";<Empty illustration="no-transactions" title="No transactions yet" description="When you send or receive money, it will show up here." primary={{ label: "Add money", href: "/add-money" }}/>أمثلة
لا نتائج
لا نتائج ليست استخدامًا أول: تكرر ما بُحث عنه وتعرض «مسح البحث»، وتُعلن (announce="status") والتركيز باقٍ في الحقل. غيّر البحث لترى القائمة.
مدمجة في بطاقة
size="compact" للمساحات الصغيرة: بلا رسم، وعنوان أصغر، والإجراء.
أزرار متراصة
stacking="vertical" للنصوص الطويلة، والأساسي في الأعلى.
الرسوم
رسوم Figma لحالة الفراغ بألوان الرموز، فتتبع الوضع الداكن ووضع العلامة. اختر ما يطابق المحتوى بـsubject، ولا تغيّر ألوانها أو تقصّها. رُسمت للعربية، فتظهر كما رُسمت هنا وتنعكس في الإنجليزية، وتبقى علامة الصح معتدلة. المقاس الافتراضي 160، و<EmptyIllustration size={240} /> للمساحات الكبيرة.
مرجع الخصائص
Empty
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
illustration | EmptyIllustrationSubject | ReactNode | لا يوجد | خانة Empty state illustration: موضوع رسم (بمقاس 160) أو أي عنصر. |
title | ReactNode | لا يوجد | خاصية Title: ما المفقود، وهو عنوان. |
description | ReactNode | لا يوجد | خاصية Description: ما سيظهر هنا أو كيف يمتلئ. |
headingLevel | 2 | 3 | 4 | 5 | 6 | 3 | مستوى عنوان الحالة. |
primary / secondary | { label; href?; render?; onClick? } | لا يوجد | الإجراء الأساسي (Filled) والثانوي (Tonal). |
stacking | "horizontal" | "vertical" | "horizontal" | خاصية Stacking. |
size | "default" | "compact" | "default" | compact للبطاقات والمساحات الصغيرة. |
announce | "status" | لا يوجد | لرسائل «لا نتائج» بعد بحث أو تصفية. |
EmptyIllustration
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
subject | EmptyIllustrationSubject | لا يوجد | خاصية Subject: ما المفقود («no-transactions»). زخرفي دائمًا. |
size | 160 | 240 | 160 | خاصية Size. |
mirror | boolean | true | يعكس الرسم في الصفحات من اليسار إلى اليمين، لأنه مرسوم للعربية. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى الإجراء الأساسي ثم الثانوي. |
ARIA
- العنوان عنوان حقيقي (
h3افتراضيًا) ليجده قارئ الشاشة. - الرسوم زخرفية ومخفية عن قارئ الشاشة، والشرح لا يكون في الرسم وحده.
- رسائل «لا نتائج» تُعلن بـ
status، ويبقى التركيز حيث كان ولا ينتقل إليها.
ملاحظات العربية والاتجاه
ينعكس
- النص يبقى في الوسط، والإجراء الأساسي أولًا: على اليمين.
- الرسم مرسوم للعربية («RTL by default» في Figma): الظل الصلب إلى اليسار والقرص في النهاية. في الإنجليزية ينعكس كله.
لا ينعكس
- علامة الصح داخل الرسم تبقى معتدلة حين ينعكس.
- الأرقام
- الأرقام في الوصف تتبع إعداد الأرقام؛ نسّقها بـ
formatNumber. - الخط العربي
- العنوان
body-20Medium (وbody-16في المدمجة) والوصفbody-14. - النص ثنائي الاتجاه
- ما بحث عنه الشخص يُعزل بـ
<bdi>لأنه قد يأتي بأي لغة.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- text-align: left مضبوطة صراحة على نص عربي في معظمه
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)