Layout e grids
VThumbnailGrid
`VThumbnailGrid` é a grade responsiva de miniaturas para mídia, arquivos e galerias. Cada item traz pré-visualização (imagem com lazy-load e fade-in, capa de vídeo ou ícone do tipo de arquivo), rótulo e metadado.
<script setup lang="ts">
import { VThumbnailGrid } from 'vueui-nova-kit'
</script>Uso
Passe items com id, label e meta; imagens e capas de vídeo usam src (com lazy-load e fade-in) e arquivos mostram o ícone pela extensão. Sem seleção, ativar uma miniatura emite open; com selection="single" ou "multiple" (ou variant="selectable"), o v-model guarda os ids e cada mudança é anunciada. actions mostra ver, baixar e mais no hover e no foco, como botões irmãos da miniatura. Setas, Home e End navegam (roving tabindex).
<script setup lang="ts">
import { ref } from 'vue'
import { VThumbnailGrid, type VThumbnailItem } from 'vueui-nova-kit'
const items: VThumbnailItem[] = [
{ id: 'montanhas', label: 'montanhas.jpg', meta: '2,4 MB · há 2 dias', src: '/img/montanhas.jpg', alt: 'Montanhas' },
{ id: 'guia', label: 'guia-da-marca.pdf', meta: '4,2 MB · há 5 dias' },
]
const selected = ref<string[]>([])
</script>
<template>
<VThumbnailGrid
v-model="selected"
:items="items"
selection="multiple"
actions
aria-label="Arquivos do projeto"
@action="({ item, action }) => executar(action, item)" />
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VThumbnailGrid.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Biblioteca de mídia com imagens, um PDF e um vídeo. Passe o mouse (ou foque com Tab) para ver as ações rápidas.
Ver código
<script setup lang="ts">
import { VThumbnailGrid } from 'vueui-nova-kit'
const items = [
{
id: 'mountains',
label: 'montanhas.jpg',
meta: '2,4 MB · há 2 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(210%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(250%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Montanhas ao amanhecer',
},
{
id: 'beach',
label: 'praia.jpg',
meta: '1,8 MB · há 3 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(190%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(230%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20120%20Q50%2095%20100%20120%20T200%20120%20V200%20H0%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.45)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Praia com ondas',
},
{
id: 'brand-guide',
label: 'guia-da-marca.pdf',
meta: '4,2 MB · há 5 dias',
fileType: 'pdf',
},
{
id: 'product-demo',
label: 'demo-do-produto.mp4',
meta: '12,4 MB · há 1 semana',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(280%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(320%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Ccircle%20cx%3D%22140%22%20cy%3D%2260%22%20r%3D%2228%22%20fill%3D%22rgba(255%2C255%2C255%2C0.7)%22%2F%3E%3Cpath%20d%3D%22M0%20160%20Q100%20110%20200%20160%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.4)%22%2F%3E%3C%2Fsvg%3E',
kind: 'video',
alt: 'Capa do vídeo de demonstração',
},
{
id: 'plant',
label: 'planta.jpg',
meta: '1,1 MB · há 1 semana',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(120%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(160%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Planta em vaso',
},
]
</script>
<template>
<VThumbnailGrid
v-model="value"
:items="items"
actions
aria-label="Biblioteca de mídia" />
</template>In Context
Biblioteca de arquivos do projeto: filtros por tipo, botão de upload e seleção múltipla com contador.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VThumbnailGrid } from 'vueui-nova-kit'
const filter = ref('all')
const filters = [
{
id: 'all',
label: 'Todos'
},
{
id: 'image',
label: 'Imagens'
},
{
id: 'video',
label: 'Vídeos'
},
{
id: 'file',
label: 'Documentos'
}
]
const selected = ref([])
const visible = () => items.value.filter((i) => filter.value === "all" || (i.kind ?? (i.src ? "image" : "file")) === filter.value)
const upload = () => items.value.push({ id: "novo-" + n, label: `novo-${n++}.jpg`, meta: "enviando\u2026", loading: true })
</script>
<template>
<div style="display:flex;flex-direction:column;gap:12px">
<div style="display:flex;flex-wrap:wrap;gap:8px;align-items:center">
<VButton v-for="f in filters" :key="f.id" size="sm" :variant="filter === f.id ? 'primary' : 'secondary'" :aria-pressed="String(filter === f.id)" @click="filter = f.id">{{ f.label }}</VButton>
<span style="margin-left:auto;font-size:13px;color:var(--v-color-text-muted)">{{ selected.length }} selecionado(s)</span>
<VButton size="sm" data-test-id="v-thumbnail-upload" aria-label="Enviar arquivo" @click="upload">+ Enviar</VButton>
</div>
<VThumbnailGrid :items="visible()" selection="multiple" v-model="selected" actions aria-label="Arquivos do projeto" />
</div>
</template>Variants
gallery (fotos), files (ícones coloridos por tipo: PDF, DOC, XLS, PPT), selectable (seleção múltipla com anel e ✓) e compact (grade densa; a legenda fica só para leitores de tela).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VThumbnailGrid } from 'vueui-nova-kit'
const media = [
{
id: 'mountains',
label: 'montanhas.jpg',
meta: '2,4 MB · há 2 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(210%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(250%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Montanhas ao amanhecer'
},
{
id: 'beach',
label: 'praia.jpg',
meta: '1,8 MB · há 3 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(190%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(230%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20120%20Q50%2095%20100%20120%20T200%20120%20V200%20H0%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.45)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Praia com ondas'
},
{
id: 'brand-guide',
label: 'guia-da-marca.pdf',
meta: '4,2 MB · há 5 dias',
fileType: 'pdf'
},
{
id: 'product-demo',
label: 'demo-do-produto.mp4',
meta: '12,4 MB · há 1 semana',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(280%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(320%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Ccircle%20cx%3D%22140%22%20cy%3D%2260%22%20r%3D%2228%22%20fill%3D%22rgba(255%2C255%2C255%2C0.7)%22%2F%3E%3Cpath%20d%3D%22M0%20160%20Q100%20110%20200%20160%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.4)%22%2F%3E%3C%2Fsvg%3E',
kind: 'video',
alt: 'Capa do vídeo de demonstração'
},
{
id: 'plant',
label: 'planta.jpg',
meta: '1,1 MB · há 1 semana',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(120%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(160%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Planta em vaso'
}
]
const files = [
{
id: 'report',
label: 'relatorio.pdf',
meta: '4,2 MB'
},
{
id: 'proposal',
label: 'proposta.docx',
meta: '820 KB'
},
{
id: 'budget',
label: 'orcamento.xlsx',
meta: '1,3 MB'
},
{
id: 'deck',
label: 'apresentacao.pptx',
meta: '9,8 MB'
}
]
const picked = ref([
'mountains'
])
</script>
<template>
<div style="display:flex;flex-direction:column;gap:24px">
<div data-test-id="docs-thumbnail-grid-variant-gallery"><p style="margin:0 0 8px;font-size:12px;color:var(--v-color-text-muted)">gallery</p><VThumbnailGrid :items="media.filter(m => m.src).slice(0, 4)" aria-label="Galeria" /></div>
<div data-test-id="docs-thumbnail-grid-variant-files"><p style="margin:0 0 8px;font-size:12px;color:var(--v-color-text-muted)">files</p><VThumbnailGrid variant="files" :items="files" aria-label="Arquivos" /></div>
<div data-test-id="docs-thumbnail-grid-variant-selectable"><p style="margin:0 0 8px;font-size:12px;color:var(--v-color-text-muted)">selectable</p><VThumbnailGrid variant="selectable" v-model="picked" :items="media.filter(m => m.src).slice(0, 4)" aria-label="Seleção" /></div>
<div data-test-id="docs-thumbnail-grid-variant-compact"><p style="margin:0 0 8px;font-size:12px;color:var(--v-color-text-muted)">compact</p><VThumbnailGrid variant="compact" size="sm" :items="media.filter(m => m.src)" aria-label="Compacta" /></div>
</div>
</template>Sizes
Tamanhos: sm (64px), md (96px, padrão) e lg (128px). A coluna cresce para preencher a linha e nunca passa da largura do container.
Ver código
<script setup lang="ts">
import { VThumbnailGrid } from 'vueui-nova-kit'
const items = [
{
id: 'mountains',
label: 'montanhas.jpg',
meta: '2,4 MB · há 2 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(210%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(250%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Montanhas ao amanhecer'
},
{
id: 'beach',
label: 'praia.jpg',
meta: '1,8 MB · há 3 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(190%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(230%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20120%20Q50%2095%20100%20120%20T200%20120%20V200%20H0%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.45)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Praia com ondas'
},
{
id: 'brand-guide',
label: 'guia-da-marca.pdf',
meta: '4,2 MB · há 5 dias',
fileType: 'pdf'
}
]
const sizes = [
'sm',
'md',
'lg'
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:24px">
<div v-for="s in sizes" :key="s" :data-test-id="'docs-thumbnail-grid-size-' + s">
<p style="margin:0 0 8px;font-size:12px;color:var(--v-color-text-muted)">{{ s }}</p>
<VThumbnailGrid :size="s" :items="items" :aria-label="'Tamanho ' + s" />
</div>
</div>
</template>States
Estados por item: padrão, hover com ações rápidas, selecionado (anel, ✓ e aria-pressed), carregando (esqueleto com shimmer e aria-busy) e desativado.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VThumbnailGrid } from 'vueui-nova-kit'
const items = [
{
id: 'default',
label: 'padrao.jpg',
meta: '2,4 MB',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(210%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(250%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Montanhas'
},
{
id: 'hover',
label: 'hover.jpg',
meta: 'passe o mouse',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(160%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(200%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20120%20Q50%2095%20100%20120%20T200%20120%20V200%20H0%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.45)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Ondas'
},
{
id: 'selected',
label: 'selecionado.jpg',
meta: '1,8 MB',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(30%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(70%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Ccircle%20cx%3D%22140%22%20cy%3D%2260%22%20r%3D%2228%22%20fill%3D%22rgba(255%2C255%2C255%2C0.7)%22%2F%3E%3Cpath%20d%3D%22M0%20160%20Q100%20110%20200%20160%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.4)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Pôr do sol'
},
{
id: 'loading',
label: 'carregando.jpg',
meta: 'enviando…',
loading: true
},
{
id: 'disabled',
label: 'desativado.jpg',
meta: 'indisponível',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(260%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(300%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Montanhas roxas',
disabled: true
}
]
const sel = ref([
'selected'
])
</script>
<template>
<VThumbnailGrid data-test-id="docs-thumbnail-grid-states" :items="items" selection="multiple" v-model="sel" actions aria-label="Estados" />
</template>Single Selection
Seleção simples (selection="single"): escolher outra miniatura troca a seleção.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VThumbnailGrid } from 'vueui-nova-kit'
const value = ref(['beach'])
const items = [
{
id: 'mountains',
label: 'montanhas.jpg',
meta: '2,4 MB · há 2 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(210%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(250%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Montanhas ao amanhecer',
},
{
id: 'beach',
label: 'praia.jpg',
meta: '1,8 MB · há 3 dias',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(190%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(230%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20120%20Q50%2095%20100%20120%20T200%20120%20V200%20H0%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.45)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Praia com ondas',
},
{
id: 'brand-guide',
label: 'guia-da-marca.pdf',
meta: '4,2 MB · há 5 dias',
fileType: 'pdf',
},
{
id: 'product-demo',
label: 'demo-do-produto.mp4',
meta: '12,4 MB · há 1 semana',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(280%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(320%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Ccircle%20cx%3D%22140%22%20cy%3D%2260%22%20r%3D%2228%22%20fill%3D%22rgba(255%2C255%2C255%2C0.7)%22%2F%3E%3Cpath%20d%3D%22M0%20160%20Q100%20110%20200%20160%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.4)%22%2F%3E%3C%2Fsvg%3E',
kind: 'video',
alt: 'Capa do vídeo de demonstração',
},
{
id: 'plant',
label: 'planta.jpg',
meta: '1,1 MB · há 1 semana',
src: 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20200%20200%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%221%22%20y2%3D%221%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22hsl(120%2070%25%2062%25)%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22hsl(160%2065%25%2038%25)%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%22200%22%20height%3D%22200%22%20fill%3D%22url(%23g)%22%2F%3E%3Cpath%20d%3D%22M0%20150%20L60%2080%20L95%20115%20L135%2060%20L200%20150%20Z%22%20fill%3D%22rgba(255%2C255%2C255%2C0.55)%22%2F%3E%3C%2Fsvg%3E',
alt: 'Planta em vaso',
},
]
</script>
<template>
<VThumbnailGrid
v-model="value"
:items="items"
aria-label="Biblioteca de mídia"
selection="single" />
</template>Files
Variante files com ícone e cor por extensão.
Ver código
<script setup lang="ts">
import { VThumbnailGrid } from 'vueui-nova-kit'
const items = [
{ id: 'report', label: 'relatorio.pdf', meta: '4,2 MB' },
{ id: 'proposal', label: 'proposta.docx', meta: '820 KB' },
{ id: 'budget', label: 'orcamento.xlsx', meta: '1,3 MB' },
{ id: 'deck', label: 'apresentacao.pptx', meta: '9,8 MB' },
]
</script>
<template>
<VThumbnailGrid
v-model="value"
:items="items"
variant="files"
aria-label="Biblioteca de mídia" />
</template>Empty
Sem itens: mostra emptyLabel (ou o slot empty).
Ver código
<script setup lang="ts">
import { VThumbnailGrid } from 'vueui-nova-kit'
const items = []
</script>
<template>
<VThumbnailGrid
v-model="value"
:items="items"
actions
aria-label="Biblioteca de mídia"
empty-label="Nenhum arquivo nesta pasta." />
</template>Acessibilidade
- Keyboard navigation (Tab, Arrow keys) — navegação sequencial e por setas (roving tabindex) entre miniaturas.
- Visible focus ring — anel de foco visível via
:focus-visible. - Descriptive alt text for images —
altdescritivo (ex.: nome do ficheiro/conteúdo). - ARIA labels for interactive actions —
aria-labelem view/download/more, play de vídeo e Upload. - Supports screen reader announcements — selecção e carregamento anunciados via
aria-live. - Clear selection state semantics —
aria-selected/aria-checkedreflectem o estado Selected. - Sufficient color contrast — label
#1F2937e meta#6B7280com contraste suficiente. - Works with dynamic content and lazy loading — conteúdo dinâmico e lazy-load acessíveis (sem perda de foco/semântica).
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
items | VThumbnailItem[] | — | Miniaturas exibidas na grade. |
size | VThumbnailGridSize | "md" | Tamanho da miniatura: `sm` 64px, `md` 96px, `lg` 128px (largura mínima da coluna proporcional). |
variant | VThumbnailGridVariant | "gallery" | Layout: `gallery` (fotos), `files` (ícones de documento), `selectable` (seleção múltipla) ou `compact` (grade densa sem legenda visível). |
selection | VThumbnailGridSelection | — | Modo de seleção. `variant="selectable"` usa `multiple` quando omitido. |
modelValue | string[] | — | IDs selecionados (`v-model`). |
actions | boolean | false | Mostra as ações rápidas no hover/foco (ver, baixar, mais). |
emptyLabel | string | "Nenhum arquivo por aqui." | Texto exibido quando não há itens. |
ariaLabel | string | — | Nome acessível da grade. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | ids: string[] | — |
@open | item: VThumbnailItem | Miniatura ativada (Enter, Espaço ou clique) quando não há seleção. |
@action | payload: { item: VThumbnailItem; action: VThumbnailAction } | Ação rápida do overlay. |
Slots
| Slot | Props do slot |
|---|---|
#preview | item |
#empty | — |
Fonte: src/components/grid/VThumbnailGrid/VThumbnailGrid.vue · tipos: src/components/grid/VThumbnailGrid/VThumbnailGrid.types.ts