On this page
@addTagHelper *, Webority.Ui.RazorA row of people
Nest avatars inside the group and they overlap into one identity row for a team or a project.
Overlapping avatars
Capping with +N
Show the first few avatars and pass the hidden count as overflow, since the group does not slice the list.
Three shown, plus a count
+2
Sizing the row
Set one size on the group and every avatar and the +N chip follows it.
One size for the group
+2
+2
+2
child size override: a group size is inherited, not forced
It sets --avatar-size on the row, which each avatar inherits, so an avatar with its own size still wins, letting you make one person larger if you need.
Spacing
Tighten the overlap for dense tables, or loosen it when the faces matter more than the space.
Tight, normal, loose
Every option
Every value of every prop, one cell each.
size: presets, a custom pixel size and a CSS length
size="xs"+1
size="sm"+1
size="md"+1
size="lg"+1
size="xl"+1
size="2xl"+1
size="72"+1
size="3rem"+1
size="md" group, one app-avatar with its own size="xl"spacing: tight, normal or loose
spacing="tight"spacing="normal" (default)spacing="loose"overflow: the “+N” chip
(omitted): no chipoverflow="0": no chipoverflow="3"+3
overflow="5": React passes a string count, parsed too+5
moreLabel: the accessible name of the chip
more-label="{count} more" (default, React moreLabel): the accessible name of the +N chip, not its text+2
className: extra classes on the group
class="…" (React className): adds extra classes to the group, no visible change herechildren: the avatars to overlap
(content): one app-avatar(content): five app-avatarsGuidance
What to do, and what to avoid.
Use it when
- Several people belong to one row or card, such as assignees, reviewers or attendees.
- You want a compact identity cluster instead of a long list of names.
- A list is longer than you want to show and a +N summary will do.
Reach for something else when
- You are showing a single person. → AppAvatar
- You need a full, scannable list of people. → AppDataTable
- The items are not people. → AppBadge
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
7 props. The 4 most used come first.
Used on most screens 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| sizedefault - | xs | sm | md | lg | xl | 2xl | - | Sizes the whole row at once. Each avatar and the +N chip inherit it; an avatar with its own size still wins. |
| spacingdefault normal | Tight | Normal | Loose | normal | How far the avatars overlap. |
| overflowdefault 0 | int | 0 | The hidden count, shown as a +N chip after the avatars. Zero or unset shows no chip. |
| more-labeldefault {count} more | string | {count} more | Replaces the built-in English text, for other languages. The {count} token is the hidden count. |
Less common 3 props
| Prop | Type | Default | Description |
|---|---|---|---|
| size-pxdefault - | number | - | The size in pixels, instead of a preset. |
| classdefault - | string | - | Extra classes on the group, merged with the component classes. |
| (content)default - | markup | - | The app-avatar children to overlap. |
Screen reader
2 notes- The group is a plain container with no role of its own; each avatar inside carries its own accessible name.
- The +N chip is announced as an image named 'N more'.