Pular para o conteúdo
Estrutura

Avatar

/componentes/avatar.mdmarkdown cru, para quem lê com agent em vez de olho

Tamanhos

EBCSRC

Com o nome ao lado

ASAna Souza

Quem tem acesso

ACEM+2
Importar
import { Avatar } from '@rivocode/ui'

Quando usar

Foto de pessoa, com a inicial por trás.

A inicial não aparece de imediato: a Base UI espera um instante, para a foto que carrega rápido não piscar a letra antes.

O nome

O fallback é a inicial, uma ou duas letras, e duas letras não dizem a quem ouve de quem é o rosto. Quando o nome já aparece escrito ao lado, o avatar é decoração e fica sem nome. Quando ele aparece sozinho, nomeie com o nome inteiro:

<Avatar fallback="CS" role="img" aria-label="Carla Souza" />

Com foto, o mesmo nome vai em alt. Dentro do AvatarGroup a regra muda: lá o fallback leva o nome inteiro, e a fila corta a inicial sozinha.

Quando não usar

Para várias pessoas numa fila (quem participa, quem já viu), use AvatarGroup: ele sobrepõe, corta para uma letra e conta o excedente em "+n", em vez de a linha esticar. A contagem por cima do avatar é Indicator, que posiciona sozinho e diz o número a quem ouve.

Foto que não é de pessoa (produto, imóvel, comprovante) não tem inicial para mostrar por trás: a imagem que segura a proporção é AspectRatio, e a que a pessoa precisa ampliar é ImageViewer.

No React Native

Traduz: o @rivocode/ui-native exporta Avatar - src remoto pela Image do core; fallback é obrigatório, porque é ele que aparece enquanto a foto baixa e se ela falhar. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.

API

PropTipoPadrão
alt0.4.0

Descricao da foto.

string""
fallback0.4.0

O que aparece sem foto, ou enquanto ela carrega: uma ou duas letras, que o circulo recorta o resto.

stringsem padrão
render0.4.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, AvatarRootState> | ReactElement<unknown, string | JSXElementConstructor<any>>sem padrão
size0.4.0"lg""md""sm"nullsem padrão
src0.4.0stringsem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

Partes

Avatar se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.

AvatarGroup

/avatar-group.md

A fila de pessoas de um lugar: quem participa, quem assinou, quem tem acesso.

Duas decisões moram na peça para não serem tomadas cinco vezes diferentes.

A sobreposição corta a inicial: com duas letras, o avatar de cima cobre a segunda letra do de baixo e o que sobra é um borrão. A fila usa uma letra só, e faz isso sozinha em vez de pedir que quem chama saiba disso. O nome não se perde no recorte: cada avatar da fila é uma imagem com o nome inteiro, o alt da foto ou o fallback antes de virar inicial, e o leitor de tela ouve "Ana Souza", e não "A". Passe o nome inteiro em fallback.

O excedente vira "+n" e não some. Uma fila de três com mais dez escondidos mente sobre o tamanho do grupo, e o número é justamente o que a pessoa procura ali. Ele também é uma imagem com nome, "mais 10 pessoas", que labels.more troca.

Quando não usar

Para uma pessoa só, use Avatar: a fila sobrepõe e corta para uma letra, e um rosto sozinho não tem o que sobrepor. Para dizer quantos avisos uma pessoa tem, e não quantas pessoas há, é Indicator por cima do Avatar.

PropTipo
labels

Os textos da peca, para trocar o idioma: `more` e o que o leitor de tela ouve no "+n", e recebe quantos ficaram de fora.

Partial<AvatarGroupLabels>
max0.5.0

Quantos aparecem antes do "+n".

number
size0.5.0

O tamanho vale para a fila inteira, inclusive para o "+n".

"lg""md""sm"null

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.