نظرة عامة
يعرضLoader نقطة متحركة داخل كبسولة صغيرة ذات حدود. استخدمه أثناء تنفيذ عملية وعندما تكون النسبة المئوية غير معروفة. للتقدم الرقمي، استخدم شريط التقدم.
استخدام
aria-hidden="true" عندما يوفّر النص المحيط أو الزر ملاحظات التحميل بالفعل.
التركيب والتسمية الأصليان
تستهدف الخصائص الأصلية وclassName وstyle وref عنصر div الحاوية. يقبل render عنصرًا أو دالة رد نداء عبر تركيب Base UI. تتجاوز الأنماط إعدادات اللون الافتراضية. يتم تصدير LoaderProps من عائلة الملاحظات.
للحصول على مؤشر مستقل، وفّر دور حالة صريحًا واسمًا متاحًا. تظل النقطة المتحركة زخرفية.
aria-labelledby بدلًا من ذلك عندما يحدد النص المرئي اسم الحالة. أبقِ مالك المنطقة الحية مُثبّتًا عندما يحتاج إلى الإعلان عن نص متغير. يتحكم التطبيق في وقت ظهور الملاحظات وما تقوله.
اللون
مرّر لونًا من لوحة ألوان النسق لتعيين كلٍّ من الحد والنقطة. من دون لون، يرث المحمّل لون الزر المحيط عند توفره، وإلا فيستخدم لون النص الثالثي. لإجراء زر، يُفضّل استخدام حالة تحميل الزر، التي تُبقي الملاحظات داخل عنصر التحكم.الإزاحة
Hide a decorative loader when another element supplies loading feedback.
string
Accessible name for a labeled loader status.
string
ID of text that names the loader status.
string
CSS class merged with the loader container class.
"amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "turquoise" | "violet" | "yellow"
Theme color for the animated dot and border. When omitted, inherits the button color if available, otherwise the tertiary text color.
Ref<HTMLDivElement>
Ref to the container div, or the element supplied through render.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Element or render callback composed through Base UI useRender.
AriaRole
Supply status to expose loading feedback as a live region. No role is assigned by default.
CSSProperties
Native styles merged with the loader color defaults. Explicit styles win.