Mídia e pessoas

VAvatar

Componente9 exemplos13 propsA2UI · Avatar

Representar pessoas, times ou entidades: ajuda a reconhecer "quem é quem", mostra presença (online/busy) e dá toque humano ao produto. Hero: "PRIMARY ACTION — Show people, teams, and presence. Avatars bring your product to life." Três atributos: **Recognizable** (pessoas, times e marcas), **Flexible** (imagens, iniciais e ícones), **Expressive** (estados de presença e uso contextual). Anotação: "Real people.

Importação
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<VAvatar src="/images/jane.jpg" alt="Jane Doe" size="md"
  status="online" badge="pro" />

Playground

Os controles abaixo são gerados a partir das props declaradas em VAvatar.types.ts; o código acompanha cada mudança.

Exemplos

Variantes, tamanhos e estados, extraídos das stories da biblioteca.

Default

Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo. Props: alt="Jane Doe", status="online".

Ver código
vue
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'
</script>

<template>
  <VAvatar
    src="https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop"
    alt="Jane Doe"
    status="online" />
</template>

Hero

Variação Hero.

Ver código
vue
<script setup lang="ts">
import { VAvatar, VGroupAvatar } from 'vueui-nova-kit'

const src = 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop'
const group = [
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop',
    alt: 'A'
  },
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop',
    alt: 'B'
  },
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop',
    alt: 'C'
  },
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop',
    alt: 'D'
  },
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop',
    alt: 'E'
  }
]
</script>

<template>
  <div style="display:flex;gap:16px;align-items:center;flex-wrap:wrap">
    <VAvatar :src="src" alt="Jane Doe" status="online" />
    <VGroupAvatar :members="group" :max="2" />
    <VAvatar :src="src" alt="Busy user" status="busy" />
    <VAvatar initials="JD" alt="Jane Doe" />
  </div>
</template>

Variants

Variação Variantes.

Ver código
vue
<script setup lang="ts">
import { VAvatar, VGroupAvatar } from 'vueui-nova-kit'

const src = 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop'
const group = [
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop'
  },
  {
    src: 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop'
  },
  {
    initials: 'C'
  },
  {
    initials: 'D'
  },
  {
    initials: 'E'
  }
]
const team = [
  {
    initials: 'A'
  },
  {
    initials: 'B'
  },
  {
    initials: 'C'
  }
]
</script>

<template>
  <div style="display:flex;gap:16px;align-items:center;flex-wrap:wrap">
    <VAvatar :src="src" alt="Photo" />
    <VAvatar initials="JD" alt="Jane Doe" />
    <VAvatar alt="Icon fallback" />
    <VGroupAvatar :members="group" :max="2" />
    <VGroupAvatar :members="team" :max="3" />
    <VAvatar :src="src" alt="Pro" badge="pro" />
    <VAvatar :src="src" alt="Square" shape="square" />
  </div>
</template>

Sizes

Variação Tamanhos.

Ver código
vue
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'

const src = 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop'
</script>

<template>
  <div style="display:flex;gap:12px;align-items:center">
    <VAvatar :src="src" alt="XS" size="xs" status="online" />
    <VAvatar :src="src" alt="SM" size="sm" status="online" />
    <VAvatar :src="src" alt="MD" size="md" status="online" />
    <VAvatar :src="src" alt="LG" size="lg" status="online" />
    <VAvatar :src="src" alt="XL" size="xl" status="online" />
  </div>
</template>

States

Variação Estados.

Ver código
vue
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'

const src = 'https://images.unsplash.com/photo-1494790108377-be9c29b29330?w=128&h=128&fit=crop'
</script>

<template>
  <div style="display:flex;gap:12px;align-items:center;flex-wrap:wrap">
    <VAvatar :src="src" alt="Default" />
    <VAvatar :src="src" alt="Selectable" selectable />
    <VAvatar :src="src" alt="Selected" selectable selected />
    <VAvatar :src="src" alt="Online" status="online" />
    <VAvatar :src="src" alt="Busy" status="busy" />
    <VAvatar alt="Loading" loading />
    <VAvatar initials="JD" alt="Fallback" />
  </div>
</template>

Selectable

Variação Selectable. Props: initials="AC", selectable=true, selected=true.

Ver código
vue
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'
</script>

<template>
  <VAvatar initials="AC" selectable selected />
</template>

Loading

Variação Carregando. Props: initials="AC", loading=true.

Ver código
vue
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'
</script>

<template>
  <VAvatar initials="AC" loading />
</template>

Overflow

Variação Overflow. Contador "+N" em pílula (border-radius: var(--v-radius-pill)), com largura mínima do avatar e padding horizontal para acomodar números longos como "+128". Props: members com 130 itens, max=2 (exibe "+128").

Ver código
vue
<script setup lang="ts">
import { VGroupAvatar } from 'vueui-nova-kit'

const many = [
  {
    initials: '0'
  },
  {
    initials: '1'
  },
  {
    initials: '2'
  },
  {
    initials: '3'
  },
  {
    initials: '4'
  },
  {
    initials: '5'
  },
  {
    initials: '6'
  },
  {
    initials: '7'
  },
  {
    initials: '8'
  },
  {
    initials: '9'
  },
  {
    initials: '10'
  },
  {
    initials: '11'
  },
  {
    initials: '12'
  },
  {
    initials: '13'
  },
  {
    initials: '14'
  },
  {
    initials: '15'
  },
  {
    initials: '16'
  },
  {
    initials: '17'
  },
  {
    initials: '18'
  },
  {
    initials: '19'
  },
  {
    initials: '20'
  },
  {
    initials: '21'
  },
  {
    initials: '22'
  },
  {
    initials: '23'
  },
  {
    initials: '24'
  },
  {
    initials: '25'
  },
  {
    initials: '0'
  },
  {
    initials: '1'
  },
  {
    initials: '2'
  },
  {
    initials: '3'
  },
  {
    initials: '4'
  },
  {
    initials: '5'
  },
  {
    initials: '6'
  },
  {
    initials: '7'
  },
  {
    initials: '8'
  },
  {
    initials: '9'
  },
  {
    initials: '10'
  },
  {
    initials: '11'
  },
  {
    initials: '12'
  },
  {
    initials: '13'
  },
  {
    initials: '14'
  },
  {
    initials: '15'
  },
  {
    initials: '16'
  },
  {
    initials: '17'
  },
  {
    initials: '18'
  },
  {
    initials: '19'
  },
  {
    initials: '20'
  },
  {
    initials: '21'
  },
  {
    initials: '22'
  },
  {
    initials: '23'
  },
  {
    initials: '24'
  },
  {
    initials: '25'
  },
  {
    initials: '0'
  },
  {
    initials: '1'
  },
  {
    initials: '2'
  },
  {
    initials: '3'
  },
  {
    initials: '4'
  },
  {
    initials: '5'
  },
  {
    initials: '6'
  },
  {
    initials: '7'
  },
  {
    initials: '8'
  },
  {
    initials: '9'
  },
  {
    initials: '10'
  },
  {
    initials: '11'
  },
  {
    initials: '12'
  },
  {
    initials: '13'
  },
  {
    initials: '14'
  },
  {
    initials: '15'
  },
  {
    initials: '16'
  },
  {
    initials: '17'
  },
  {
    initials: '18'
  },
  {
    initials: '19'
  },
  {
    initials: '20'
  },
  {
    initials: '21'
  },
  {
    initials: '22'
  },
  {
    initials: '23'
  },
  {
    initials: '24'
  },
  {
    initials: '25'
  },
  {
    initials: '0'
  },
  {
    initials: '1'
  },
  {
    initials: '2'
  },
  {
    initials: '3'
  },
  {
    initials: '4'
  },
  {
    initials: '5'
  },
  {
    initials: '6'
  },
  {
    initials: '7'
  },
  {
    initials: '8'
  },
  {
    initials: '9'
  },
  {
    initials: '10'
  },
  {
    initials: '11'
  },
  {
    initials: '12'
  },
  {
    initials: '13'
  },
  {
    initials: '14'
  },
  {
    initials: '15'
  },
  {
    initials: '16'
  },
  {
    initials: '17'
  },
  {
    initials: '18'
  },
  {
    initials: '19'
  },
  {
    initials: '20'
  },
  {
    initials: '21'
  },
  {
    initials: '22'
  },
  {
    initials: '23'
  },
  {
    initials: '24'
  },
  {
    initials: '25'
  },
  {
    initials: '0'
  },
  {
    initials: '1'
  },
  {
    initials: '2'
  },
  {
    initials: '3'
  },
  {
    initials: '4'
  },
  {
    initials: '5'
  },
  {
    initials: '6'
  },
  {
    initials: '7'
  },
  {
    initials: '8'
  },
  {
    initials: '9'
  },
  {
    initials: '10'
  },
  {
    initials: '11'
  },
  {
    initials: '12'
  },
  {
    initials: '13'
  },
  {
    initials: '14'
  },
  {
    initials: '15'
  },
  {
    initials: '16'
  },
  {
    initials: '17'
  },
  {
    initials: '18'
  },
  {
    initials: '19'
  },
  {
    initials: '20'
  },
  {
    initials: '21'
  },
  {
    initials: '22'
  },
  {
    initials: '23'
  },
  {
    initials: '24'
  },
  {
    initials: '25'
  }
]
const few = [
  {
    initials: 'A'
  },
  {
    initials: 'B'
  },
  {
    initials: 'C'
  }
]
</script>

<template>
  <div style="display:flex;gap:16px;align-items:center;flex-wrap:wrap">
    <VGroupAvatar :members="many" :max="2" />
    <VGroupAvatar :members="few" :max="2" />
  </div>
</template>

Decorative

Variação Decorative. Props: initials="AC", decorative=true.

Ver código
vue
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'
</script>

<template>
  <VAvatar initials="AC" decorative />
</template>

Acessibilidade

Tabela Accessibility ("Inclusive by design", 8 linhas):

  • Alternative text — "Use descriptive alt text" (alt="Jane Doe").
  • Initials fallback — "Show initials when no image" (nunca caixa vazia).
  • Status indicator — "Not the only means of conveying status" (dot + texto).
  • Keyboard support — "Focusable and selectable".
  • Screen reader — "Meaningful labels (e.g. 'Jane Doe, online')"

(aria-label, role="img"/botão conforme o caso).

  • Color contrast — "Meets WCAG 2.1 AA (≥ 4.5:1)" (iniciais/ícone sobre fundo).
  • Non-color cues — "Use icons / text in addition to color".
  • Reduced motion — "Respects user preference".
  • Foco sempre visível via :focus-visible; avatar puramente decorativo =

aria-hidden="true" + alt="".

Props

PropTipoDefaultDescrição
srcstring——
altstring——
initialsstring——
sizeVAvatarSize"md"—
shapeVAvatarShape"circle"—
statusVAvatarStatus——
badgeVAvatarBadge——
selectablebooleanfalse—
selectedboolean——
loadingbooleanfalse—
decorativebooleanfalse—
ariaLabelstring——
dataTestIdstring——

Events

EventoPayloadDescrição
@clickMouseEvent—
@selectMouseEvent—
@update:selectedboolean—

Slots

Sem slots.

Fonte: src/components/images/VAvatar/VAvatar.vue · tipos: src/components/images/VAvatar/VAvatar.types.ts