MarsalaDS

Buscar

Páginas e componentes da documentação

Avatar

MD

Uso

Identidade circular: AvatarImage quando há foto, AvatarFallback com iniciais caso contrário. Tamanhos sm, default e lg; AvatarBadge para status; AvatarGroup com sobreposição e AvatarGroupCount para excedentes (+N).

Quando usar

  • Sempre incluir AvatarFallback com iniciais ou ícone quando usar AvatarImage.
  • AvatarGroup em listas de membros; AvatarGroupCount para quem não cabe na pilha.
  • AvatarBadge discreto (ex.: online) — respeita o size do avatar.

Evite quando

  • Não use avatar sem significado (decoração pura em listas densas).
  • Evite imagens não quadradas sem recorte — use object-cover via AvatarImage.
  • Não confundir AvatarBadge com o componente Badge de etiquetas.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/avatar

Exemplos

Variações comuns de uso.

Foto com fallback

MD

Somente iniciais

MD

Tamanhos

SMMDLG

Com status

MD

Grupo

A1B2C3

Grupo com contagem

A1B2C3
+5
Marsala Design System