الهيكل المؤقت
يُظهر شكل المحتوى أثناء تحميله، فلا تقفز الصفحة حين يصل المحتوى الحقيقي.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add skeletonويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/skeletonأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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. الموجة شريط بنصف عرض الشكل يمرّ باتجاه القراءة. |
className | string | لا يوجد | المقاس والشكل: h-space-12 w-full لسطر، size-space-40 rounded-full لصورة شخصية. |
SkeletonRegion
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
loading | boolean | true | aria-busy والتسمية المخفية أثناء التحميل. |
label | ReactNode | “Loading…” | ما يُقرأ أثناء التحميل. |
إمكانية الوصول
ARIA
- المنطقة
aria-busy="true"أثناء التحميل مع تسمية مخفية؛ الأشكال مخفية عن قارئ الشاشة. - تتوقف الحركة عند تفعيل تقليل الحركة.
- لا تُبقِ الهيكل عند فشل التحميل؛ اعرض رسالة خطأ.
ملاحظات العربية والاتجاه
ينعكس
- الأشكال تتبع تخطيط المحتوى: الدائرة في بداية السطر (اليمين).
- الموجة تمرّ من بداية السطر إلى نهايته: من اليمين إلى اليسار في العربية.
لا ينعكس
- النبض بلا اتجاه.
- الأرقام
- لا أرقام.
- الخط العربي
- اجعل ارتفاع أسطر الهيكل قريبًا من ارتفاع السطر العربي الأطول.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.