Pular para o conteúdo
UI

Avatar

Um elemento de imagem com fallback para representar o usuário.

Exemplos

Variantes

CN
CN
LR
ER

Fallback

ER

Tamanhos

CN
ER
LR
ER

Com badge

8CN
3ER
20LR
47ER

API

Avatar

PropriedadeTipoValores possíveisPadrãoDescrição
size"sm" | "md" | "lg" | "xl""sm", "md", "lg", "xl""md"Define o tamanho do avatar, das iniciais do fallback e do badge.
badgenumber | string--Conteúdo exibido como badge no avatar (normalmente para notificações ou contadores). Fica oculto quando o valor é 0 ou vazio. Leitores de tela anunciam o badge como "N notificações" (ou "1 notificação"), como o badge do Button.
srcstring--Atalho que renderiza um AvatarImage com essa URL quando nenhum children é passado.
altstring-""Texto alternativo da imagem do atalho.
fallbackReact.ReactNode--Atalho que renderiza um AvatarFallback com esse conteúdo quando nenhum children é passado. Mostra o ícone de usuário quando só src é informado.
classNamestring--Classes CSS adicionais aplicadas ao avatar. Sem badge, o avatar é o próprio elemento raiz, e classes de layout (como ml-auto) valem nele.
containerClassNamestring--Classes aplicadas ao wrapper que envolve o avatar e o badge. Só existe com badge; use para posicionar o conjunto (ex.: ml-auto numa linha flex).
childrenReact.ReactNode--Componentes filhos (normalmente AvatarImage e AvatarFallback).
...propsTodas as props de Avatar do Radix--Permite passar qualquer outra propriedade padrão do componente.

AvatarImage

PropriedadeTipoValores possíveisPadrãoDescrição
srcstring--URL de origem da imagem do avatar.
altstring--Texto alternativo da imagem do avatar.
classNamestring--Classes CSS adicionais aplicadas à imagem do avatar.
...propsTodas as props de AvatarImage do Radix--Permite passar qualquer outra propriedade padrão do componente.

AvatarFallback

PropriedadeTipoValores possíveisPadrãoDescrição
childrenReact.ReactNode-Ícone de usuárioConteúdo exibido quando a imagem do avatar não carrega. Sem children, exibe por padrão um ícone de usuário.
classNamestring--Classes CSS adicionais aplicadas ao fallback do avatar.
...propsTodas as props de AvatarFallback do Radix--Permite passar qualquer outra propriedade padrão do componente.