الصورة الرمزية
تمثّل شخصًا أو حسابًا بصورة أو بالحرف الأول من الاسم أو برمز عام، وقد تحمل شارة للتعديل أو التوثيق أو الاتصال.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add avatarويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/avatarالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Avatar } from "@/components/ui/avatar";<Avatar name="Layla Haddad" src={photoUrl} status="verified" />أمثلة
الأنواع والمقاسات والحالات
صورة، أو الحرف الأول من name، أو type="placeholder"، أو type="add" لإضافة صورة؛ خمسة مقاسات؛ وstatus للتعديل أو التوثيق أو الاتصال.
حين لا تُحمَّل الصورة
تظهر الأحرف الأولى أثناء التحميل أو عند الفشل: حرف عربي واحد للاسم العربي، وحرفان للاسم اللاتيني، وinitials لتحديدها يدويًا؛ والرمز العام إن لم يوجد اسم.
شعار شركة
type="company-logo": مربع بزوايا مستديرة يحمل logo (أو صورة src تُحتوى كاملة بلا قصّ)، واسم الشركة في name. استخدم نسخة الشعار المخصّصة للخلفية الفاتحة؛ وبلا شعار تظهر الأحرف الأولى.
مجموعة صور رمزية
AvatarGroup يُراكبها، وأولها من جهة بداية السطر في الأعلى. max يُظهر عددًا محدّدًا ويضيف الباقي إلى count، فيظهر «+N» بأرقام الصفحة. المقاسات sm وmd وlg للمجموعة تقابل xs وsm وmd للصورة.
مرجع الخصائص
Avatar
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
name | string | لا يوجد | اسم الشخص أو الحساب: النص البديل ومصدر الأحرف الأولى. |
src | string | لا يوجد | خاصية Type = Photo. |
type | "placeholder" | "initials" | "add" | "company-logo" | لا يوجد | خاصية Type من دون صورة. |
logo | ReactNode | لا يوجد | خاصية Logo مع type="company-logo": شعار زخرفي، والاسم في name. |
initials | string | لا يوجد | بدل الأحرف المستخرجة من الاسم. |
size | "xxs" | "xs" | "sm" | "md" | "lg" | "md" | 24 و32 و40 و48 و60 بكسل. |
status | "none" | "edit" | "verified" | "online" | "none" | خاصية Status: شارة في زاوية نهاية السطر السفلية. |
decorative | boolean | false | يخفيها عن قارئ الشاشة حين يظهر الاسم بجانبها. |
AvatarGroup
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
size | "sm" | "md" | "lg" | "sm" | خاصية Size للمجموعة: صور بمقاس xs أو sm أو md. |
count | number | 0 | خاصية Count: عدد من لا تظهر صورهم. |
max | number | لا يوجد | أقصى عدد من الصور يظهر؛ والباقي يُضاف إلى العدد. |
label | string | لا يوجد | اسم المجموعة لقارئ الشاشة («أعضاء المشروع»). |
countLabel | (count) => ReactNode | لا يوجد | ما يُقرأ بعد الأسماء. الافتراضي «و٩ آخرون». |
إرشادات الاستخدام
الصورة الرمزية تمثّل شخصًا أو حسابًا بصورة أو بالأحرف الأولى. هنا: أي نوع، وأي مقاس، والأحرف الأولى للأسماء العربية، وشارات الحالة، وموضع الشارة في العربية، وما تتحقق منه قبل التسليم.
1. أي نوع
اعرض أفضل ما لديك: الصورة، ثم الأحرف الأولى من الاسم، ثم الصورة الافتراضية العامة. و«الإضافة» خانة لرفع صورة، فقط حيث يدير الناس ملفهم الشخصي.
| النوع | الاستخدام |
|---|---|
| صورة | أشخاص وحسابات لها صورة. وأثناء التحميل أو عند الفشل تظهر الأحرف الأولى مكانها. |
| أحرف أولى | أشخاص لهم اسم بلا صورة. |
| صورة افتراضية | لا صورة ولا اسم بعد، مثل جهة اتصال مدعوّة. |
| إضافة | ملف المستخدم نفسه قبل رفع صورة؛ والضغط عليه يفتح الرفع. |
2. المقاسات
لكل سياق مقاسه. وأبقِ مقاسًا واحدًا في القائمة الواحدة لتصطف الصفوف.
| المقاس | الاستخدام |
|---|---|
xxs · 24 | داخل النص، والمجموعات المكدّسة، والتعليقات. |
xs · 32 | صفوف الجداول والقوائم الكثيفة. |
sm · 40 | عناصر القوائم والقوائم المنسدلة. |
md · 48 | البطاقات والرؤوس وصفوف جهات الاتصال. |
lg · 60 | رؤوس الملفات الشخصية وشاشات الحساب. |
3. الأحرف الأولى والأسماء العربية
يجب أن تُقرأ الأحرف الأولى بخط الاسم نفسه. فللاسم العربي اعرض أول حرف عربي منه؛ وللاسم اللاتيني أول حرفي الكلمتين الأولى والأخيرة. ويستخرجها الكود من الاسم. والاسم الذي تُعلنه قارئات الشاشة هو الاسم الكامل.
أحرف أولى بخط الاسم
جهة اتصال عربية بلا صورة.
افعل
- حرف عربي واحد للاسم العربي.
- حرفان للاسم اللاتيني: Layla Haddad تصبح LH.
- مرّر الاسم الكامل؛ ويستخرج الكود الأحرف الأولى والاسم المُعلن.
تجنّب
- نقل اسم عربي إلى أحرف أولى لاتينية.
- عرض ثلاثة أحرف أو أكثر.
- استخدام الأحرف الأولى حين تتوفر صورة.
4. شارات الحالة
تضيف الشارة معلومة واحدة: «تعديل» (يستطيع الشخص تغيير الصورة)، أو «موثّق» (الحساب مؤكَّد)، أو «متصل» (متاح الآن). وتقع في الزاوية السفلية عند نهاية السطر. ويقرؤها الكود مع الاسم، «ليلى حداد، موثّق»، فلا تكون الشارة الإشارة الوحيدة أبدًا.
افعل
- شارة واحدة في كل مرة، فقط حين تهم المهمة.
- احصر «موثّق» في الحسابات الموثّقة فعلًا.
- اعرض حالة الاتصال نصًا أيضًا حيث تهم، مثل رأس المحادثة.
تجنّب
- تكديس عدة شارات على صورة رمزية واحدة.
- الاعتماد على النقطة الخضراء وحدها للقول إن الشخص متصل.
- استخدام الشارة للأعداد؛ ضع شارة عدد بجوار الاسم.
5. العربية والاتجاه من اليمين إلى اليسار
في النسخة العربية تنتقل الشارة إلى أسفل اليسار، وهو نهاية السطر في العربية، وتستخدم الأحرف الأولى حرفًا عربيًا واحدًا. ولا تنعكس الصور أبدًا: الوجه المقلوب وجه آخر.
الشارة عند نهاية السطر
حساب موثّق بالعربية.
قبل التسليم
- بدائل الصورة والأحرف الأولى والصورة الافتراضية مصمّمة.
- مقاس واحد في كل قائمة.
- الأسماء العربية بحرف عربي واحد، واللاتينية بحرفين.
- الشاشات العربية تستخدم النسخة العربية، والشارة في أسفل اليسار.
إمكانية الوصول
ARIA
-
role="img"باسم الشخص والحالة بلغة الصفحة («ليلى حداد، موثّق»)؛ النقطة الخضراء ليست الإشارة الوحيدة. - شارة التعديل زخرفية: الزر الذي يحيط بالصورة يسمّي الإجراء («تغيير الصورة»).
- المجموعة
role="group"باسمها، وكل صورة تُقرأ باسمها، ثم «و٩ آخرون»؛ الرمز «+٩» نفسه مخفي عن قارئ الشاشة.
افعل
- مرّر الاسم الكامل، فتُعلَن الصورة الرمزية باسم صاحبها.
- أخفِها عن قارئات الشاشة حين يُكتب الاسم بجوارها مباشرة (
decorative). - أبقِ الأحرف الأولى مقروءة:
text/gray/mutedعلى الحاوية يبلغ مستوى AA.
تجنّب
- ترك الصورة الرمزية بلا اسم.
- إعلان الصورة الرمزية والاسم المجاور لها معًا.
ملاحظات العربية والاتجاه
ينعكس
- الشارة في زاوية نهاية السطر السفلية: يسارًا في العربية.
- في المجموعة تبدأ الصور من اليمين، والأولى فوق التي تليها، والعدد في آخرها يسارًا.
لا ينعكس
- الصورة وعلامة التوثيق والقلم وشعار الشركة لا تنعكس.
- الأرقام
- عدد المجموعة يتبع نظام الأرقام في الصفحة («+٩»)، وعلامة + قبل الرقم في الاتجاهين.
- الخط العربي
- الاسم العربي حرف عربي واحد (ل لليلى)، لا حرفان لاتينيان؛ الأحرف بخط IBM Plex Sans Arabic بوزن SemiBold.
- النص ثنائي الاتجاه
- ضع الاسم الظاهر بجانبها في
<bdi>: الاسم اللاتيني في قائمة عربية يبقى سليمًا.
افعل
- النسخة العربية في القوائم العربية، والشارة في أسفل اليسار.
- أبقِ الصور كما رُفعت تمامًا.
تجنّب
- عكس الصورة.
- إبقاء الشارة في أسفل اليمين في الشاشات العربية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.