الانتقال إلى المحتوى الرئيسي

نظرة عامة

يتلقى AvatarGroup الصور الرمزية المعروضة ويستنتج العدد المخفي. يعدّ maxVisible الصور الرمزية الفعلية؛ ومؤشر التجاوز يكون إضافيًا. ثماني صور رمزية مقدمة مع maxVisible={3} تعرض ثلاث صور رمزية و+5.

استخدام

وفّر مفاتيح مستقرة للحفاظ على تركيب الصور الرمزية المتبقية عند تغيّر الحد أو الإجمالي أو ترتيب العرض. الصور الرمزية زخرفية افتراضيا. عندما تكون المجموعة هي التمثيل الوحيد لأعضائها، وفّر اسم كل عضو عبر imageProps.alt لتسمية الصورة والبديل الافتراضي. أبقِ الصور الرمزية زخرفية عندما يكون النص المرئي أو تسمية المالك يوفران هذه الهوية بالفعل.

خيارات العرض

قارن بين الصور الرمزية الدائرية والمربعة في كل حجم. تحتفظ المجموعة بثلاثة أعضاء ظاهرين في هذه المقارنة.

المجموعات المحمّلة جزئيًا

استخدم total لحجم المجموعة الكامل عندما لا تكون سوى بعض الصور الرمزية محمّلة. ثلاث صور رمزية مقدمة ومرئية مع total={20} تعرض +17. مرّر جميع الصور الرمزية المحمّلة ودع المجموعة تطبّق maxVisible.
يُقرّب total إلى الأسفل ولا يمكن أن يكون أصغر من عدد الصور الرمزية القابلة للعرض المقدمة. تستخدم الإجماليات غير المنتهية العدد المقدّم. يكون العدد المخفي المشتق غير سالب دائمًا. القيمة الافتراضية لـ maxVisible هي 4. تُقرّب الحدود المنتهية إلى الأسفل وتُقيّد بالصفر، ويعرض Infinity جميع الصور الرمزية المقدمة، بينما لا يعرض NaN أيًا منها. لا تُحتسب عقد React الفارغة كصور رمزية. يمكن أن يعرض الحد الصفري مؤشر التجاوز فقط. يمكن لمجموعة فارغة ذات إجمالي موجب أن تعرض ذلك الإجمالي في مؤشرها؛ أما المجموعة الفارغة التي لا تحتوي على صور رمزية مخفية فلا تعرض شيئًا.

تجاوز مخصص

يتلقى renderOverflow العدد المخفي المشتق نفسه الذي يتلقاه مؤشر +N الافتراضي. لا يعمل إلا عندما يكون ذلك العدد موجبًا. أعد null لإخفاء المؤشر دون تغيير الصور الرمزية المرئية. استخدم عنصر تحكم صريحًا عندما ينفذ المؤشر إجراءً. ينبغي أن يوضح اسمه المتاح الإجراء والعدد.

المظهر

تُعرَض الصور الرمزية اللاحقة دائمًا فوق الصور السابقة. يختار overlap الهامش الفعلي، left أو right، الذي يحمل الإزاحة السالبة. يعيّن overlapOffset تلك الإزاحة كطول CSS. يعيّن overflowShape شكل المؤشر الرقمي الافتراضي.

تخصيص الجذر

تصل السمات الأصلية ومعالجات الأحداث وclassName وstyle إلى الجذر. عنصره الافتراضي هو div، بما في ذلك عند توفير onClick. استخدم العناصر التفاعلية الأصلية للإجراءات، مثل زر التجاوز أعلاه. يقبل الجذر ref وrender، والذي يمكن أن يكون عنصرًا أو دالة. يجب أن تمرّر المكونات المخصصة الـ props وref المقدمة إلى جذرها الأصلي. راجع المكونات المخصصة لمتطلبات التركيب.

الخصائص

يتم تصدير AvatarGroupProps من twenty-ui/components/data-display.
ReactNode[]
مطلوب
Avatar elements in display order. Empty React nodes are ignored. Supply stable keys to preserve identity when reordering.
string
Class applied to the group container.
number
افتراضي:"4"
Maximum number of actual avatars to show, excluding the overflow indicator. Floored and clamped to zero; Infinity shows all avatars and NaN shows none.
"circle" | "rounded-square" | "square"
افتراضي:"square"
Shape of the numeric overflow indicator.
"left" | "right"
افتراضي:"right"
Physical margin, left or right, that carries the negative overlap offset. Later avatars always render above earlier ones.
string
افتراضي:"3px"
CSS length of the overlap between avatars.
Ref<HTMLDivElement>
Ref to the rendered root element.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Element or render function for the root. Forward the supplied props and ref; the default element is a div.
((hiddenCount: number) => ReactNode)
Called with the derived hidden count when it is positive. Return a custom indicator, or null to hide it.
number
Total collection size for partially loaded avatars. Floored and never smaller than the supplied renderable count; nonfinite values use the supplied count.