전체 카탈로그
ContentAvatar5 props

Avatar Group

AvatarGroup displays multiple avatars in an overlapping row with an optional overflow indicator. Uses a compositional API: pass Avatar children directly so each avatar can carry...

공식 문서 열기
live previewContent

Preview

+4

Import

import {AvatarGroup} from '@astryxdesign/core/AvatarGroup';

Astryx 문서 권장 방식대로 root barrel이 아니라 컴포넌트 subpath에서 가져옵니다.

When to use

AvatarGroup displays multiple avatars in an overlapping row with an optional overflow indicator. Uses a compositional API: pass Avatar children directly so each avatar can carry...

avatargroupfacepilestackoverlapparticipantsassigneesmembers

Important props

이 컴포넌트는 주요 variant prop보다 children/compound pattern 중심으로 사용합니다.

Theming targets

astryx-avatar-group

Best practices

  • DoSet max to limit visible avatars when the list is long; 3-5 is typical.
  • DoUse AvatarGroupOverflow for custom overflow content like a popover trigger or "add member" button.
  • DoPass status dots, click handlers, or tooltips directly on each Avatar child.
  • Do notDon't nest AvatarGroups; use a single group with all avatars.