Layout e grids

VMasonryGrid

Componente8 exemplos6 propsA2UI · MasonryGrid

Layout de conteúdo de altura variável ("masonry"): organiza itens de alturas diferentes em colunas responsivas, sem espaços mortos ("gapless"), com fluxo visual natural. Ideal para galerias, feeds de artigos, portfólios e qualquer conteúdo onde alturas flexíveis criam uma navegação mais natural, estilo "magazine-like".

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

Uso

Exemplo
<script setup lang="ts">
import { VMasonryGrid } from 'vueui-nova-kit'
</script>

<template>
  <VMasonryGrid cols=3 gap=6 loading />
</template>

Playground

Os controles abaixo são gerados a partir das props declaradas em VMasonryGrid.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. Slots usados: #media.

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

const args = {
  cols: 3,
  gap: 6
}
const items = [
  {
    id: 'mountains',
    title: 'Serene mountains',
    category: 'Nature',
    likes: 342,
    h: 220
  },
  {
    id: 'mind',
    title: 'A calmer mind',
    category: 'Lifestyle',
    likes: 128,
    h: 120
  },
  {
    id: 'village',
    title: 'Coastal village',
    category: 'Travel',
    likes: 521,
    h: 160
  },
  {
    id: 'canyon',
    title: 'Into the canyon',
    category: 'Adventure',
    likes: 299,
    h: 240
  },
  {
    id: 'workspace',
    title: 'Minimal workspace',
    category: 'Design',
    likes: 416,
    h: 160
  },
  {
    id: 'cat',
    title: 'Curious friend',
    category: 'Animals',
    likes: 312,
    h: 160
  }
]
</script>

<template>
  <VMasonryGrid v-bind="args">
    <VMasonryItem
      v-for="item in items"
      :key="item.id"
      :id="item.id"
      :title="item.title"
      :category="item.category"
      :likes="item.likes">
      <template #media>
        <div :style="{ height: item.h + 'px', background: 'linear-gradient(135deg,var(--v-color-primary-200),var(--v-color-info-soft))' }" />
      </template>
    </VMasonryItem>
  </VMasonryGrid>
</template>

Two Columns

Variação Two Columns. Props: cols=2.

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

const args = {
  cols: 2,
  gap: 6
}
const items = [
  {
    id: 'mountains',
    title: 'Serene mountains',
    category: 'Nature',
    likes: 342,
    h: 220
  },
  {
    id: 'mind',
    title: 'A calmer mind',
    category: 'Lifestyle',
    likes: 128,
    h: 120
  },
  {
    id: 'village',
    title: 'Coastal village',
    category: 'Travel',
    likes: 521,
    h: 160
  },
  {
    id: 'canyon',
    title: 'Into the canyon',
    category: 'Adventure',
    likes: 299,
    h: 240
  },
  {
    id: 'workspace',
    title: 'Minimal workspace',
    category: 'Design',
    likes: 416,
    h: 160
  },
  {
    id: 'cat',
    title: 'Curious friend',
    category: 'Animals',
    likes: 312,
    h: 160
  }
]
</script>

<template>
  <VMasonryGrid v-bind="args">
    <VMasonryItem
      v-for="item in items"
      :key="item.id"
      :id="item.id"
      :title="item.title"
      :category="item.category"
      :likes="item.likes">
      <template #media>
        <div :style="{ height: item.h + 'px', background: 'linear-gradient(135deg,var(--v-color-primary-200),var(--v-color-info-soft))' }" />
      </template>
    </VMasonryItem>
  </VMasonryGrid>
</template>

Responsive Cols

Variação Responsive Cols. Props: gap=6.

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

const args = {
  cols: {
    xs: 2,
    md: 3,
    lg: 4
  },
  gap: 6
}
const items = [
  {
    id: 'mountains',
    title: 'Serene mountains',
    category: 'Nature',
    likes: 342,
    h: 220
  },
  {
    id: 'mind',
    title: 'A calmer mind',
    category: 'Lifestyle',
    likes: 128,
    h: 120
  },
  {
    id: 'village',
    title: 'Coastal village',
    category: 'Travel',
    likes: 521,
    h: 160
  },
  {
    id: 'canyon',
    title: 'Into the canyon',
    category: 'Adventure',
    likes: 299,
    h: 240
  },
  {
    id: 'workspace',
    title: 'Minimal workspace',
    category: 'Design',
    likes: 416,
    h: 160
  },
  {
    id: 'cat',
    title: 'Curious friend',
    category: 'Animals',
    likes: 312,
    h: 160
  }
]
</script>

<template>
  <VMasonryGrid v-bind="args">
    <VMasonryItem
      v-for="item in items"
      :key="item.id"
      :id="item.id"
      :title="item.title"
      :category="item.category"
      :likes="item.likes">
      <template #media>
        <div :style="{ height: item.h + 'px', background: 'linear-gradient(135deg,var(--v-color-primary-200),var(--v-color-info-soft))' }" />
      </template>
    </VMasonryItem>
  </VMasonryGrid>
</template>

Loading

Variação Carregando. Props: loading=true.

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

<template>
  <VMasonryGrid loading />
</template>

Empty

Variação Vazio. Props: empty=true.

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

<template>
  <VMasonryGrid empty />
</template>

Selected Tile

Variação Selected Tile. Slots usados: #media.

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

const items = [
  {
    id: 'mountains',
    title: 'Serene mountains',
    category: 'Nature',
    likes: 342,
    h: 220
  },
  {
    id: 'mind',
    title: 'A calmer mind',
    category: 'Lifestyle',
    likes: 128,
    h: 120
  },
  {
    id: 'village',
    title: 'Coastal village',
    category: 'Travel',
    likes: 521,
    h: 160
  },
  {
    id: 'canyon',
    title: 'Into the canyon',
    category: 'Adventure',
    likes: 299,
    h: 240
  },
  {
    id: 'workspace',
    title: 'Minimal workspace',
    category: 'Design',
    likes: 416,
    h: 160
  },
  {
    id: 'cat',
    title: 'Curious friend',
    category: 'Animals',
    likes: 312,
    h: 160
  }
]
</script>

<template>
  <VMasonryGrid :cols="3" :gap="6">
    <VMasonryItem id="selected" title="Selected item" category="Demo" :selected="true" :likes="42">
      <template #media><div style="height:140px;background:var(--v-color-primary-100)" /></template>
    </VMasonryItem>
    <VMasonryItem v-for="item in items.slice(1,4)" :key="item.id" v-bind="item">
      <template #media><div :style="{ height: item.h + 'px', background: 'var(--v-color-surface-muted)' }" /></template>
    </VMasonryItem>
  </VMasonryGrid>
</template>

Variant Magazine

Variação Variante Magazine. Props: variant="magazine".

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

<template>
  <VMasonryGrid variant="magazine" />
</template>

Variant Image First

Variação Variante imagem First. Props: variant="image-first".

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

<template>
  <VMasonryGrid variant="image-first" />
</template>

Acessibilidade

Checklist do pôster (7 itens):

  • Suporta navegação por teclado (Tab, Arrow keys).
  • Alt text significativo para imagens (:alt="item.title").
  • Funciona com leitores de tela.
  • Mantém ordem lógica do documento (DOM = ordem de leitura, não ordem visual).
  • Indicadores de foco nos itens interativos.
  • ARIA roles e labels.
  • Responsivo e independente de conteúdo.
  • Implicação: tiles focáveis com tabindex/role adequada, aria-label

descritivo, foco nunca removido via CSS, respeitar prefers-reduced-motion.

Props

PropTipoDefaultDescrição
colsVGridCols3—
gapnumber6—
variantVMasonryGridVariant"default"—
loadingbooleanfalse—
emptybooleanfalse—
ariaLabelstring——

Events

Não emite eventos.

Slots

SlotProps do slot
#default—

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