Skip to main content

Avatar

Apresentação

O componente Avatar é responsável por exibir avatares de usuários na interface, podendo ser usados para representar perfis, contatos ou qualquer outra representação visual de usuário.

Quando usar

  • Para exibir fotos de perfil de usuários
  • Para representar contatos em listas
  • Quando precisar de uma representação visual padronizada de usuários
  • Para exibir avatares em grupos (usando AvatarGroup)

Forma básica de uso

import { Avatar } from 'eitri-luminus';

// Avatar básico
<Avatar>
<Avatar.Image
src="/caminho/do/avatar.jpg"
alt="Nome do usuário"
/>
</Avatar>

// Avatar com tamanho personalizado
<Avatar>
<Avatar.Image
src="/caminho/do/avatar.jpg"
alt="Nome do usuário"
className="w-32"
/>
</Avatar>

Propriedades

Avatar

PropriedadeTipoDescrição
classNamestringClasses CSS adicionais para o container
idstringIdentificador único do componente

Avatar.Image

PropriedadeTipoDescrição
srcstringURL da imagem do avatar
altstringTexto alternativo para acessibilidade
classNamestringClasses CSS adicionais para a imagem

Heranças

O componente Avatar herda todas as propriedades comuns da biblioteca através da interface CommonProps, que inclui:

  • Propriedades de estilo (margin, padding, etc)
  • Propriedades de layout (flex, grid, etc)
  • Propriedades de posicionamento
  • Propriedades de acessibilidade
  • Propriedades de identificação (id, data-e)

Observações

  • O componente tem um tamanho padrão de 24 unidades (w-24)
  • É possível personalizar o tamanho usando classes de largura do Tailwind
  • O componente suporta imagens em diferentes formatos (JPG, PNG, WebP, etc)
  • Recomenda-se sempre fornecer um texto alternativo para acessibilidade
  • O componente é responsivo por padrão