Layout e grids

VThumbnailGrid

Componentev-model8 exemplos8 propsA2UI · ThumbnailGrid

`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.

Importação
<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).

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

  1. Keyboard navigation (Tab, Arrow keys) — navegação sequencial e por setas (roving tabindex) entre miniaturas.
  2. Visible focus ring — anel de foco visível via :focus-visible.
  3. Descriptive alt text for images — alt descritivo (ex.: nome do ficheiro/conteúdo).
  4. ARIA labels for interactive actions — aria-label em view/download/more, play de vídeo e Upload.
  5. Supports screen reader announcements — selecção e carregamento anunciados via aria-live.
  6. Clear selection state semantics — aria-selected / aria-checked reflectem o estado Selected.
  7. Sufficient color contrast — label #1F2937 e meta #6B7280 com contraste suficiente.
  8. Works with dynamic content and lazy loading — conteúdo dinâmico e lazy-load acessíveis (sem perda de foco/semântica).

Props

PropTipoDefaultDescrição
itemsVThumbnailItem[]—Miniaturas exibidas na grade.
sizeVThumbnailGridSize"md"Tamanho da miniatura: `sm` 64px, `md` 96px, `lg` 128px (largura mínima da coluna proporcional).
variantVThumbnailGridVariant"gallery"Layout: `gallery` (fotos), `files` (ícones de documento), `selectable` (seleção múltipla) ou `compact` (grade densa sem legenda visível).
selectionVThumbnailGridSelection—Modo de seleção. `variant="selectable"` usa `multiple` quando omitido.
modelValuestring[]—IDs selecionados (`v-model`).
actionsbooleanfalseMostra as ações rápidas no hover/foco (ver, baixar, mais).
emptyLabelstring"Nenhum arquivo por aqui."Texto exibido quando não há itens.
ariaLabelstring—Nome acessível da grade.

Events

EventoPayloadDescrição
@update:modelValueids: string[]—
@openitem: VThumbnailItemMiniatura ativada (Enter, Espaço ou clique) quando não há seleção.
@actionpayload: { item: VThumbnailItem; action: VThumbnailAction }Ação rápida do overlay.

Slots

SlotProps do slot
#previewitem
#empty—

Fonte: src/components/grid/VThumbnailGrid/VThumbnailGrid.vue · tipos: src/components/grid/VThumbnailGrid/VThumbnailGrid.types.ts