data-display/DSAvatarGroup

DSAvatarGroup

data-display
since v1.0

Overlapping stack of avatars with a '+N' overflow indicator when the list exceeds the max.

iOS 17+macOS 14+

Purpose

Display project collaborators, message participants, or event attendees in a compact format.

Props

PropTypeDefaultDescription
itemsreq[(initials: String, tint: Color)]โ€”Avatar data array.
sizeDSAvatarSize.smSize of each avatar.
maxInt3Maximum visible avatars before the overflow indicator.

Examples

Project members

Team members on a project card.

swift
DSAvatarGroup(
    items: members.map { ($0.initials, $0.color) },
    size: .sm,
    max: 4
)

Related Components