pro-ui

Avatar

User avatar with image, initials fallback, and size variants. AvatarGroup stacks multiple avatars.

Import

import { Avatar, AvatarGroup } from '@dangbt/pro-ui'

Basic usage

{/* With image */}
<Avatar src="/avatar.jpg" name="John Doe" />
 
{/* Initials fallback */}
<Avatar name="Jane Smith" />
 
{/* Initials only, no name */}
<Avatar />

Sizes

<Avatar name="John Doe" size="sm" />
<Avatar name="John Doe" size="md" />
<Avatar name="John Doe" size="lg" />
<Avatar name="John Doe" size="xl" />

AvatarGroup

<AvatarGroup max={3}>
  <Avatar name="Alice" />
  <Avatar name="Bob" />
  <Avatar name="Charlie" />
  <Avatar name="Diana" />
  <Avatar name="Edward" />
</AvatarGroup>

Shows the first 3, then +2 overflow indicator.

Props

Avatar

PropTypeDefaultDescription
srcstringImage URL
namestringName for initials fallback and aria-label
size'sm' | 'md' | 'lg' | 'xl''md'Avatar size

AvatarGroup

PropTypeDefaultDescription
maxnumberMaximum avatars to show before overflow indicator
childrenReactNodeAvatar components

On this page