SusAvatarGroup
![]()
Stacked party / roster avatars with overflow +N when Items exceed Max.
Package
SusKit · Atoms (commercial)
Props
| Name | Type | Default | |
|---|---|---|---|
Max | Prop<int> | 3 | v-model |
Size | Prop<string> | "default" | v-model |
Rounded | Prop<string> | "circle" | v-model |
Slots
No slots.
Events
No public events.
Style hooks
USS class contract — override appearance without touching C#. States toggle via these classes:
sus-avatar-groupsus-avatar-group__avatarsus-avatar-group__avatar--firstsus-avatar-group__moresus-avatar-group__rowsus-avatar-group--defaultsus-avatar-group--largesus-avatar-group--smallsus-avatar-group--x-largesus-avatar-group--x-small
Usage
Items are set in code (List<AvatarGroupItem>). Each item carries Text, optional Image / Color / Status.
csharp
var group = new SusAvatarGroup();
group.Size.Value = "default";
group.Max.Value = 3;
group.Rounded.Value = "circle";
group.Items.Value = new List<SusAvatarGroup.AvatarGroupItem>
{
new() { Text = "Alice", Color = "primary", Status = "online" },
new() { Text = "Bob", Color = "success", Status = "away" },
new() { Text = "Cara", Color = "info", Status = "busy" },
new() { Text = "Dan", Color = "warning", Status = "offline" },
};| Prop | Role |
|---|---|
Items | List<AvatarGroupItem> — faces to stack |
Max | How many avatars before +N overflow |
Size / Rounded | Applied to every child avatar |