Avatar Group

Stacks user avatars into a single overlapping cluster, with a configurable stacking direction and one size for the whole group.

import { Avatar, AvatarGroup } from "@plexui/vue/components/Avatar";

Examples

Overview

Stacking direction

stack

Group sizing

size
48

API

PropTypeDefaultDescription
default slotVNode[]—The avatars of the group
sizenumber—Size of all avatars in the group
stack"start" | "end""start"Stacking direction
classstring—Applied to the group container; other attributes are not forwarded

Styling

Avatar Group reads these component tokens. Override them at any scope to restyle it:

  • --avatar-font-size-scaling: font size scaling (default 0.5)
  • --avatar-group-cutout-color: cutout color (default var(--color-surface))
  • --avatar-group-cutout-width: cutout width (default 3px)
  • --avatar-group-spacing: spacing (default -8px)
  • --avatar-image-border-color: image border color (default light-dark(var(--alpha-04), var(--alpha-15)))
  • --avatar-overflow-font-size-scaling-one: overflow font size scaling one (default 0.45)
  • --avatar-overflow-font-size-scaling-three: overflow font size scaling three (default 0.3)
  • --avatar-overflow-font-size-scaling-two: overflow font size scaling two (default 0.37)
  • --avatar-radius: radius (default var(--radius-full))
  • --avatar-size: size (default 28px)