هيكل تحميل

Skeleton

عنصر نائب في React يحاكي شكل المحتوى أثناء التحميل: أسطر نص ودوائر وبطاقات وأشكال مضمّنة، بلمعان يحترم تفضيل تقليل الحركة.

يحاكي Skeleton شكل المحتوى أثناء تحميله. وهو aria-hidden، لذا علم السطح الجاري تحميله بـ aria-busy="true".

متى تستخدمه

استخدم Skeleton حين يكون تخطيط المحتوى القادم معروفًا، مثل قائمة بطاقات أو ترويسة ملف شخصي، لتحافظ الصفحة على شكلها أثناء تحميل البيانات. طابق الهيكل مع التخطيط النهائي لتجنّب القفزة.

للانتظار المجهول أو القصير يكفي Spinner. لا تعرض الهياكل أكثر من ثوانٍ قليلة دون تغذية راجعة.

أمثلة

الأشكال

عنصر نائب لبطاقة

عنصر نائب مضمّن

مرحبًا بعودتك،

! يجري تحميل ملفك الشخصي.

الخصائص

الخصائص التي يعرّفها Skeleton. سمات العنصر الأصلي تمرّ كما هي.

الخاصيةالنوعالافتراضيالوصف
shape"circle" | "text" | "square" | "rectangle"
animation"none" | "shimmer"
widthstring | numberInline width override (any valid CSS length, e.g. "60%", 200, "4rem"). Defaults: text100%; rectangle100%; circle/square40px.
heightstring | numberInline height override. Defaults: text1em (tracks line-height, ≈ SDGA Line 22/14); rectangle40px (= SDGA Large); circle/square → matches width (aspect-ratio 1).

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

Skeleton مخفي بـ aria-hidden، فلا يراه قارئ الشاشة. علّم سطح التحميل بـ aria-busy="true" وأعلن الاكتمال عبر منطقة حيّة عند وصول المحتوى.

تتعطّل حركة اللمعان حين يفضّل المستخدم تقليل الحركة.