Layout e grids
VMasonryGrid
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".
<script setup lang="ts">
import { VMasonryGrid } from 'vueui-nova-kit'
</script>Uso
<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
<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
<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
<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
<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
<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
<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
<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
<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
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
cols | VGridCols | 3 | — |
gap | number | 6 | — |
variant | VMasonryGridVariant | "default" | — |
loading | boolean | false | — |
empty | boolean | false | — |
ariaLabel | string | — | — |
Events
Não emite eventos.
Slots
| Slot | Props do slot |
|---|---|
#default | — |
Fonte: src/components/grid/VMasonryGrid/VMasonryGrid.vue · tipos: src/components/grid/VMasonryGrid/VMasonryGrid.types.ts