Avatar
Tamanhos
Com o nome ao lado
Quem tem acesso
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
| Prop | Tipo | Padrão |
|---|---|---|
alt0.4.0Descricao da foto. | string | "" |
fallback0.4.0O que aparece sem foto, ou enquanto ela carrega: uma ou duas letras, que o circulo recorta o resto. | string | sem padrão |
render0.4.0Troca 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"null | sem padrão |
src0.4.0 | string | sem 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.mdA 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.
| Prop | Tipo |
|---|---|
labelsOs 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.0Quantos aparecem antes do "+n". | number |
size0.5.0O 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.