مؤشر التحميل
يخبر الناس أن شيئًا يجري حين لا يمكن معرفة المدة. مؤشر التحميل يضيف عنوانًا ووصفًا قصيرًا.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add spinnerويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/spinnerأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { LoadingIndicator, Spinner } from "@/components/ui/spinner";<LoadingIndicator title="Checking your balance" description="This usually takes a few seconds." /><Spinner size={24} color="brand" label="Loading" />أمثلة
الألوان والمقاسات والنقاط
color للعلامة أو الداكن أو الفاتح حسب السطح، وcurrent يتبع لون النص (في الأزرار). LoadingDots ثلاث نقاط تقفز. أضف label ليُعلَن.
إنجليزيمعكوسعربي
← RTL
مرجع الخصائص
LoadingIndicator
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
title | ReactNode | “Loading…” | خاصية Title: ما يجري تحميله. |
description | ReactNode | لا يوجد | خاصية Description. |
spinner | ReactNode | لا يوجد | خانة Spinner: أي مؤشر أو LoadingDots. |
Spinner
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
size | 16 | 20 | 24 | 32 | 40 | 48 | لا يوجد | أو حدّده بـclassName. |
color | "current" | "brand" | "dark" | "light" | "current" | خاصية Color، وcurrent للون النص. |
label | ReactNode | لا يوجد | يجعله role="status" يعلن النص؛ بدونه زخرفي. |
LoadingDots
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | ReactNode | لا يوجد | كما في Spinner. |
إمكانية الوصول
ARIA
- مؤشر التحميل
role="status"، فيُعلَن عنوانه ووصفه. - تتوقف الحركة عند تفعيل تقليل الحركة.
- لا تعرضه لانتظار أقل من ثانية، ولا أكثر من مؤشر في الشاشة.
ملاحظات العربية والاتجاه
ينعكس
- النقاط تقفز بترتيب القراءة.
لا ينعكس
- المؤشر يدور مع عقارب الساعة في الاتجاهين.
- الأرقام
- لا أرقام.
- الخط العربي
- العنوان
label-14بوزن Medium والوصفlabel-12؛ النص في الوسط.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.