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

مؤشر التحميل

احصل على Ritla UI

يخبر الناس أن شيئًا يجري حين لا يمكن معرفة المدة. مؤشر التحميل يضيف عنوانًا ووصفًا قصيرًا.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add spinner

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

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

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

الاستخدام

spinner.tsx
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

الخاصيةالنوعالافتراضيالوصف
titleReactNode“Loading…”خاصية Title: ما يجري تحميله.
descriptionReactNodeلا يوجدخاصية Description.
spinnerReactNodeلا يوجدخانة Spinner: أي مؤشر أو LoadingDots.

Spinner

الخاصيةالنوعالافتراضيالوصف
size16 | 20 | 24 | 32 | 40 | 48لا يوجدأو حدّده بـclassName.
color"current" | "brand" | "dark" | "light""current"خاصية Color، وcurrent للون النص.
labelReactNodeلا يوجديجعله role="status" يعلن النص؛ بدونه زخرفي.

LoadingDots

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدكما في Spinner.

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

ARIA

  • مؤشر التحميل role="status"، فيُعلَن عنوانه ووصفه.
  • تتوقف الحركة عند تفعيل تقليل الحركة.
  • لا تعرضه لانتظار أقل من ثانية، ولا أكثر من مؤشر في الشاشة.

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

ينعكس

  • النقاط تقفز بترتيب القراءة.

لا ينعكس

  • المؤشر يدور مع عقارب الساعة في الاتجاهين.
الأرقام
لا أرقام.
الخط العربي
العنوان label-14 بوزن Medium والوصف label-12؛ النص في الوسط.

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

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

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