نظرة عامة
يجمعStatus بين نقطة ملوّنة وتسمية نصية ومؤشر تحميل اختياري. استخدمه لحالات سير العمل أو السجل. استخدم الوسم لفئة من دون مؤشر الحالة.
استخدام
color مطلوب ويستخدم لوحة ألوان النسق. تنقل التسمية المعنى بصورة مستقلة عن اللون. العنصر الافتراضي هو دائمًا span، بما في ذلك عند توفير معالج نقر أصلي؛ تؤكد weight="medium" نصه.
التحميل والإعلانات
loading أداة تحميل زخرفية بعد التسمية ويضبط aria-busy افتراضيًا على true. وفّر aria-busy صراحةً عندما يكون سير العمل المحيط مسؤولًا عن تلك الحالة. لا يضيف المكوّن منطقة حية ولا يغيّر نصه تلقائيًا. أبقِ حاوية role="status" مركّبة عندما ينبغي الإعلان عن التحديثات للتقنية المساعدة، وقدّم تسمية تصف الحالة الحالية.
تغيير حالة
render. ضع معالج النقر والسمات الأصلية والمرجع وحالة التعطيل على ذلك العنصر المالك. يوفر الزر الحقيقي التركيز والتنشيط بالمؤشر وبمفتاح Enter وبمفتاح Space. يعرض Status.loading التقدم؛ مرّر disabled إلى الزر عندما يجب أن ينتظر الإجراء. للتنقل، اعرض رابطًا بوجهته، مثل <a href="/records" />. تحتفظ العناصر المالكة الأصلية بمظهر Status. تحافظ العقد الفرعية على النص والترجمات والروابط المقصودة التي يملكها المستدعي.
الإزاحة
تُولَّد الأنواع والقيم الافتراضية من أنواع المكوّن العامة. تُقبل أيضًا السمات الأصلية ومعالجات الأحداث."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 used for the status background, text, and loader.
boolean
افتراضي:"false"
Shows a decorative loader after the label and defaults aria-busy to true. The caller owns announcements and disabled interaction.
MouseEventHandler<HTMLSpanElement>
Native click handler. Does not change the default span or add keyboard activation.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, StatusState>
Replaces the default span. Compose a button or link to provide explicit interaction semantics.
"medium" | "regular"
افتراضي:"regular"
Font weight of the label.