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

الحالة الفارغة

احصل على Ritla UI

تملأ مساحة لا محتوى فيها بعد، وتقول السبب، وتدل على الخطوة التالية.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add empty

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

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

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

الاستخدام

empty.tsx
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" }}/>

أمثلة

تعذّر التحميل

قل ما حدث بكلمات بسيطة واعرض «أعد المحاولة».

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

مدمجة في بطاقة

‏size="compact" للمساحات الصغيرة: بلا رسم، وعنوان أصغر، والإجراء.

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

أزرار متراصة

‏stacking="vertical" للنصوص الطويلة، والأساسي في الأعلى.

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

الرسوم

رسوم Figma لحالة الفراغ بألوان الرموز، فتتبع الوضع الداكن ووضع العلامة. اختر ما يطابق المحتوى بـsubject، ولا تغيّر ألوانها أو تقصّها. رُسمت للعربية، فتظهر كما رُسمت هنا وتنعكس في الإنجليزية، وتبقى علامة الصح معتدلة. المقاس الافتراضي 160، و<EmptyIllustration size={240} /> للمساحات الكبيرة.

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

مرجع الخصائص

Empty

الخاصيةالنوعالافتراضيالوصف
illustrationEmptyIllustrationSubject | ReactNodeلا يوجدخانة Empty state illustration: موضوع رسم (بمقاس 160) أو أي عنصر.
titleReactNodeلا يوجدخاصية Title: ما المفقود، وهو عنوان.
descriptionReactNodeلا يوجدخاصية Description: ما سيظهر هنا أو كيف يمتلئ.
headingLevel2 | 3 | 4 | 5 | 63مستوى عنوان الحالة.
primary / secondary{ label; href?; render?; onClick? }لا يوجدالإجراء الأساسي (Filled) والثانوي (Tonal).
stacking"horizontal" | "vertical""horizontal"خاصية Stacking.
size"default" | "compact""default"‏compact للبطاقات والمساحات الصغيرة.
announce"status"لا يوجدلرسائل «لا نتائج» بعد بحث أو تصفية.

EmptyIllustration

الخاصيةالنوعالافتراضيالوصف
subjectEmptyIllustrationSubjectلا يوجدخاصية Subject: ما المفقود («no-transactions»). زخرفي دائمًا.
size160 | 240160خاصية Size.
mirrorbooleantrueيعكس الرسم في الصفحات من اليسار إلى اليمين، لأنه مرسوم للعربية.

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

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

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

المفتاحما يفعله
Tabإلى الإجراء الأساسي ثم الثانوي.

ARIA

  • العنوان عنوان حقيقي (h3 افتراضيًا) ليجده قارئ الشاشة.
  • الرسوم زخرفية ومخفية عن قارئ الشاشة، والشرح لا يكون في الرسم وحده.
  • رسائل «لا نتائج» تُعلن بـ status، ويبقى التركيز حيث كان ولا ينتقل إليها.

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

ينعكس

  • النص يبقى في الوسط، والإجراء الأساسي أولًا: على اليمين.
  • الرسم مرسوم للعربية («RTL by default» في Figma): الظل الصلب إلى اليسار والقرص في النهاية. في الإنجليزية ينعكس كله.

لا ينعكس

  • علامة الصح داخل الرسم تبقى معتدلة حين ينعكس.
الأرقام
الأرقام في الوصف تتبع إعداد الأرقام؛ نسّقها بـ formatNumber.
الخط العربي
العنوان body-20 Medium (وbody-16 في المدمجة) والوصف body-14.
النص ثنائي الاتجاه
ما بحث عنه الشخص يُعزل بـ <bdi> لأنه قد يأتي بأي لغة.

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

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

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