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

الهيكل المؤقت

احصل على Ritla UI

يُظهر شكل المحتوى أثناء تحميله، فلا تقفز الصفحة حين يصل المحتوى الحقيقي.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add skeleton

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

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

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

الاستخدام

skeleton.tsx
import { Skeleton, SkeletonRegion } from "@/components/ui/skeleton";<SkeletonRegion loading={isLoading}>  {isLoading ? <Skeleton className="h-space-12 w-full" /> : <Contacts />}</SkeletonRegion>

أمثلة

النبض ثم المحتوى

animation="pulse" يبدّل لون الشكل بلا اتجاه، بدل الموجة الافتراضية. حين يصل المحتوى تتوقف المنطقة عن aria-busy ولا يقفز التخطيط.

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

مرجع الخصائص

Skeleton

الخاصيةالنوعالافتراضيالوصف
animation"wave" | "pulse" | "none""wave"خاصية Animation. الموجة شريط بنصف عرض الشكل يمرّ باتجاه القراءة.
classNamestringلا يوجدالمقاس والشكل: h-space-12 w-full لسطر، size-space-40 rounded-full لصورة شخصية.

SkeletonRegion

الخاصيةالنوعالافتراضيالوصف
loadingbooleantrue‏aria-busy والتسمية المخفية أثناء التحميل.
labelReactNode“Loading…”ما يُقرأ أثناء التحميل.

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

ARIA

  • المنطقة aria-busy="true" أثناء التحميل مع تسمية مخفية؛ الأشكال مخفية عن قارئ الشاشة.
  • تتوقف الحركة عند تفعيل تقليل الحركة.
  • لا تُبقِ الهيكل عند فشل التحميل؛ اعرض رسالة خطأ.

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

ينعكس

  • الأشكال تتبع تخطيط المحتوى: الدائرة في بداية السطر (اليمين).
  • الموجة تمرّ من بداية السطر إلى نهايته: من اليمين إلى اليسار في العربية.

لا ينعكس

  • النبض بلا اتجاه.
الأرقام
لا أرقام.
الخط العربي
اجعل ارتفاع أسطر الهيكل قريبًا من ارتفاع السطر العربي الأطول.

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

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

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