Mídia e pessoas
VAvatar
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.
<script setup lang="ts">
import { VAvatar } from 'vueui-nova-kit'
</script>Uso
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
src | string | — | — |
alt | string | — | — |
initials | string | — | — |
size | VAvatarSize | "md" | — |
shape | VAvatarShape | "circle" | — |
status | VAvatarStatus | — | — |
badge | VAvatarBadge | — | — |
selectable | boolean | false | — |
selected | boolean | — | — |
loading | boolean | false | — |
decorative | boolean | false | — |
ariaLabel | string | — | — |
dataTestId | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@click | MouseEvent | — |
@select | MouseEvent | — |
@update:selected | boolean | — |
Slots
Sem slots.
Fonte: src/components/images/VAvatar/VAvatar.vue · tipos: src/components/images/VAvatar/VAvatar.types.ts