Avatar group

WantedAvatarGroup

여러 개의 아바타를 그룹 형태로 겹쳐 보여주는 컴포넌트입니다. 좌우로 겹쳐진 형태의 아바타와 우측에 추가 텍스트나 콘텐츠를 표시할 수 있습니다. Drawable 리소스 또는 URL 기반 이미지 모두를 지원합니다. 아바타는 [WantedAvatarDefaults.MAX_GROUP_VISIBLE_COUNT]명까지만 표시하며, 초과 인원은 호출부가 [trailingContent]로 처리합니다(예: "외 N명"). 그룹은 Person 형태만 제공합니다. Company·Academy가 필요하면 단독 [WantedAvatar]를 사용합니다. 크기는 Figma·iOS 와 동일하게 [WantedAvatarGroupSize] 의 XSmall·Small 2종만 지원합니다.

WantedAvatarGroup(
    modelList = listOf(R.drawable.ic_avatar_placeholder_person),
    modifier = Modifier,
    placeHolder = R.drawable.ic_avatar_placeholder_person,
    size = WantedAvatarGroupSize.XSmall,
    isDrawableRes = true,
    contentDescription = "프로필 이미지",
    trailingContent = { WantedAvatarGroupTrailingText(text = "외 3명") }
)

Parameters

Advanced

WantedAvatarGroupTrailingText

[WantedAvatarGroup]의 trailingContent 슬롯에 사용하는 텍스트 프리셋입니다. 색상 Foreground/Neutral/Secondary, 타이포 Label 1/Normal - Medium 토큰이 고정 적용되며, 표시 상한(5명)을 초과한 인원을 안내하는 용도로 주로 사용합니다.

WantedAvatarGroup(
    modelList = modelList,
    size = WantedAvatarGroupSize.XSmall,
    trailingContent = { WantedAvatarGroupTrailingText(text = "외 3명") }
)

WantedAvatarGroupTrailingTextButton

[WantedAvatarGroup]의 trailingContent 슬롯에 사용하는 텍스트 버튼 프리셋입니다. [WantedTextButton] 위에 trailing 스펙의 색·타이포 토큰을 적용한 형태로, [WantedAvatarGroupTrailingText]와 보이는 모습은 같고 클릭 영역만 추가됩니다. 밑줄 등 별도의 시각적 구분은 두지 않습니다.

WantedAvatarGroup(
    modelList = modelList,
    size = WantedAvatarGroupSize.XSmall,
    trailingContent = {
        WantedAvatarGroupTrailingTextButton(text = "외 3명", onClick = { /* 클릭 동작 */ })
    }
)

WantedAvatarGroupDefaults

Avatar Group 컴포넌트에서 사용하는 설정 값을 정의하는 객체입니다.

Enum

WantedAvatarGroupSize