Layout e grids
VAutoLayoutGrid
Grelha que decide sozinha quantas colunas cabem: cada coluna tem no mínimo `minItemWidth` px e cresce para ocupar o espaço livre. Ao redimensionar o container, os itens reorganizam-se sem media queries. `behavior` escolhe auto-fit (colunas vazias colapsam), auto-fill (mantém colunas vazias), dense (preenche buracos deixados por itens com `colSpan`/`rowSpan`) ou equal-height (linhas com a mesma altura).
<script setup lang="ts">
import { VAutoLayoutGrid } from 'vueui-nova-kit'
</script>Uso
<template>
<VAutoLayoutGrid
:min-item-width="280"
:gap="16">
<ProjectCard
v-for="project in projects"
:key="project.id" />
</VAutoLayoutGrid>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VAutoLayoutGrid.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Grelha com minItemWidth=220. Use a aba Controls para alterar largura mínima, gap, behavior e size ao vivo; as colunas recalculam-se de imediato.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem, VAvatar, VBadge } from 'vueui-nova-kit'
const args = {
minItemWidth: 220,
behavior: 'auto-fit',
size: 'medium'
}
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
</script>
<template>
<VAutoLayoutGrid v-bind="args">
<VAutoLayoutGridItem v-for="p in projects" :key="p.id" :id="p.id" :interactive="false">
<div style="display:flex;justify-content:space-between;align-items:center;gap:8px">
<VAvatar :initials="p.who" size="sm" />
<VBadge :variant="p.variant" size="sm">{{ p.tag }}</VBadge>
</div>
<div style="margin-top:12px"><strong>{{ p.title }}</strong></div>
<div style="color:var(--v-color-text-muted);font-size:13px;margin-top:4px">{{ p.meta }}</div>
</VAutoLayoutGridItem></VAutoLayoutGrid>
</template>Reflow responsivo
A mesma grade em containers de 300, 520 e 860 px. O número de colunas muda sem nenhuma media query: o navegador divide o espaço disponível por minItemWidth. Cada container também é redimensionável arrastando o canto.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem, VAvatar, VBadge } from 'vueui-nova-kit'
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
const widths = [
300,
520,
860
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:24px">
<div v-for="w in widths" :key="w" :style="{ width: w + 'px', maxWidth: '100%', resize: 'horizontal', overflow: 'auto', padding: '12px', border: '1px dashed var(--v-color-border)', borderRadius: '8px' }">
<VAutoLayoutGrid :min-item-width="200" :gap="12">
<VAutoLayoutGridItem v-for="p in projects" :key="p.id" :id="p.id" :interactive="false">
<div style="display:flex;justify-content:space-between;align-items:center;gap:8px">
<VAvatar :initials="p.who" size="sm" />
<VBadge :variant="p.variant" size="sm">{{ p.tag }}</VBadge>
</div>
<div style="margin-top:12px"><strong>{{ p.title }}</strong></div>
<div style="color:var(--v-color-text-muted);font-size:13px;margin-top:4px">{{ p.meta }}</div>
</VAutoLayoutGridItem></VAutoLayoutGrid>
</div>
</div>
</template>Largura mínima
Contentor fixo de 720 px com minItemWidth de 140, 240 e 360. Quanto maior o mínimo, menos colunas e itens mais largos.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem } from 'vueui-nova-kit'
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
const mins = [
140,
240,
360
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:20px;max-width:720px">
<VAutoLayoutGrid v-for="m in mins" :key="m" :min-item-width="m" :gap="12">
<VAutoLayoutGridItem v-for="p in projects.slice(0, 6)" :key="p.id" :interactive="false">
<strong>{{ p.title }}</strong>
<div style="color:var(--v-color-text-muted);font-size:13px;margin-top:4px">{{ p.meta }}</div>
</VAutoLayoutGridItem></VAutoLayoutGrid>
</div>
</template>Auto-fit vs auto-fill
Com apenas 2 itens num container largo: auto-fit estica os itens para ocupar toda a linha; auto-fill mantém as colunas vazias e os itens ficam com a largura de uma coluna.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem, VBadge } from 'vueui-nova-kit'
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:20px;max-width:900px">
<VAutoLayoutGrid v-for="b in ['auto-fit','auto-fill']" :key="b" :behavior="b" :min-item-width="200">
<VAutoLayoutGridItem v-for="p in projects.slice(0, 2)" :key="p.id" :interactive="false">
<VBadge :variant="b === 'auto-fit' ? 'primary' : 'purple'" size="sm">{{ b }}</VBadge>
<div style="margin-top:8px"><strong>{{ p.title }}</strong></div>
</VAutoLayoutGridItem>
</VAutoLayoutGrid>
</div>
</template>Gaps e tamanhos
Linhas 1 a 3: size compact, medium e spacious (sem gap). Linha 4: gap=32. Linha 5: rowGap=32 com columnGap=8.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem } from 'vueui-nova-kit'
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
const sizes = [
'compact',
'medium',
'spacious'
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:28px;max-width:760px">
<VAutoLayoutGrid v-for="s in sizes" :key="s" :size="s" :min-item-width="160">
<VAutoLayoutGridItem v-for="p in projects.slice(0, 6)" :key="p.id" :interactive="false">
<strong>{{ p.title }}</strong>
<div style="color:var(--v-color-text-muted);font-size:13px;margin-top:4px">{{ p.meta }}</div>
</VAutoLayoutGridItem></VAutoLayoutGrid>
<VAutoLayoutGrid :gap="32" :min-item-width="160">
<VAutoLayoutGridItem v-for="p in projects.slice(0, 6)" :key="p.id" :interactive="false">
<strong>{{ p.title }}</strong>
<div style="color:var(--v-color-text-muted);font-size:13px;margin-top:4px">{{ p.meta }}</div>
</VAutoLayoutGridItem></VAutoLayoutGrid>
<VAutoLayoutGrid :row-gap="32" :column-gap="8" :min-item-width="160">
<VAutoLayoutGridItem v-for="p in projects.slice(0, 6)" :key="p.id" :interactive="false">
<strong>{{ p.title }}</strong>
<div style="color:var(--v-color-text-muted);font-size:13px;margin-top:4px">{{ p.meta }}</div>
</VAutoLayoutGridItem></VAutoLayoutGrid>
</div>
</template>Dense com spans
Itens com colSpan/rowSpan deixam buracos. À esquerda, auto-fit mantém a ordem e deixa lacunas; à direita, behavior="dense" reordena visualmente para preencher os espaços.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem } from 'vueui-nova-kit'
const tiles = [
{
id: 'a',
t: 'Receita',
c: 2,
r: 1
},
{
id: 'b',
t: 'Usuários',
c: 1,
r: 1
},
{
id: 'c',
t: 'Mapa de calor',
c: 2,
r: 2
},
{
id: 'd',
t: 'Erros',
c: 1,
r: 1
},
{
id: 'e',
t: 'Latência',
c: 1,
r: 1
},
{
id: 'f',
t: 'Sessões',
c: 1,
r: 1
},
{
id: 'g',
t: 'Conversão',
c: 1,
r: 1
}
]
</script>
<template>
<div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(380px,1fr));gap:24px">
<VAutoLayoutGrid v-for="b in ['auto-fit','dense']" :key="b" :behavior="b" :min-item-width="90" :gap="8" style="grid-template-columns:repeat(4,1fr);grid-auto-rows:72px">
<VAutoLayoutGridItem v-for="t in tiles" :key="t.id" :col-span="t.c" :row-span="t.r" :interactive="false" style="min-height:0">
<strong>{{ t.t }}</strong>
</VAutoLayoutGridItem>
</VAutoLayoutGrid>
</div>
</template>Altura igual
behavior="equal-height": todas as linhas têm a altura do item mais alto, por isso cartões com conteúdo curto e longo ficam alinhados e os botões no fundo.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem, VButton, VBadge } from 'vueui-nova-kit'
</script>
<template>
<VAutoLayoutGrid behavior="equal-height" :min-item-width="220">
<VAutoLayoutGridItem :interactive="false" style="display:flex;flex-direction:column;gap:8px"><strong>Starter</strong><span style="color:var(--v-color-text-muted)">Para projetos pessoais.</span><div style="margin-top:auto"><VButton size="sm">Escolher</VButton></div></VAutoLayoutGridItem>
<VAutoLayoutGridItem :interactive="false" style="display:flex;flex-direction:column;gap:8px"><strong>Pro</strong><div><VBadge variant="primary" size="sm">Popular</VBadge></div><span style="color:var(--v-color-text-muted)">Para equipes em crescimento: SSO, auditoria, domínios personalizados, suporte prioritário e relatórios avançados de uso.</span><div style="margin-top:auto"><VButton size="sm">Escolher</VButton></div></VAutoLayoutGridItem>
<VAutoLayoutGridItem :interactive="false" style="display:flex;flex-direction:column;gap:8px"><strong>Enterprise</strong><span style="color:var(--v-color-text-muted)">Contratos sob medida.</span><div style="margin-top:auto"><VButton size="sm" variant="secondary">Falar com vendas</VButton></div></VAutoLayoutGridItem>
</VAutoLayoutGrid>
</template>Com cartões
Galeria de VCard dentro da grade, redimensionável arrastando o canto do container.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VCard, VBadge } from 'vueui-nova-kit'
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
</script>
<template>
<div style="resize:horizontal;overflow:auto;width:760px;max-width:100%;padding:12px;border:1px dashed var(--v-color-border);border-radius:8px">
<VAutoLayoutGrid :min-item-width="200">
<VCard v-for="p in projects.slice(0, 6)" :key="p.id" :title="p.title" :description="p.meta" variant="outlined">
<template #header-trailing><VBadge :variant="p.variant" size="sm">{{ p.tag }}</VBadge></template>
</VCard>
</VAutoLayoutGrid>
</div>
</template>Selectable
Itens interativos: clique ou Enter/Espaço emitem select. O primeiro mostra o estado selecionado.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem } from 'vueui-nova-kit'
const args = {
minItemWidth: 220,
behavior: 'auto-fit',
size: 'medium',
selectable: true
}
const projects = [
{
id: 'design-system',
title: 'Design System',
meta: '24 componentes',
tag: 'Ativo',
variant: 'success',
who: 'AM'
},
{
id: 'brand-assets',
title: 'Brand Assets',
meta: '143 ficheiros',
tag: 'Revisão',
variant: 'warning',
who: 'JP'
},
{
id: 'team',
title: 'Equipa',
meta: '8 membros',
tag: 'Novo',
variant: 'primary',
who: 'LS'
},
{
id: 'analytics',
title: 'Analytics',
meta: 'Últimos 30 dias',
tag: 'Ativo',
variant: 'success',
who: 'RC'
},
{
id: 'documentation',
title: 'Documentação',
meta: '56 artigos',
tag: 'Rascunho',
variant: 'neutral',
who: 'MB'
},
{
id: 'components',
title: 'Componentes',
meta: '112 ficheiros',
tag: 'Ativo',
variant: 'success',
who: 'TF'
},
{
id: 'projects',
title: 'Projetos',
meta: '12 em curso',
tag: 'Atraso',
variant: 'danger',
who: 'CN'
},
{
id: 'settings',
title: 'Definições',
meta: 'Preferências da conta',
tag: 'Roxo',
variant: 'purple',
who: 'PV'
}
]
</script>
<template>
<VAutoLayoutGrid v-bind="args">
<VAutoLayoutGridItem id="design-system" selected><strong>Design System</strong><div style="color:var(--v-color-text-muted)">Selecionado</div></VAutoLayoutGridItem>
<VAutoLayoutGridItem v-for="p in projects.slice(1, 5)" :key="p.id" :id="p.id"><strong>{{ p.title }}</strong><div style="color:var(--v-color-text-muted)">{{ p.meta }}</div></VAutoLayoutGridItem>
</VAutoLayoutGrid>
</template>States
Estados do item: normal, selecionado, a arrastar e desativado.
Ver código
<script setup lang="ts">
import { VAutoLayoutGrid, VAutoLayoutGridItem } from 'vueui-nova-kit'
</script>
<template>
<VAutoLayoutGrid :min-item-width="180" :gap="12">
<VAutoLayoutGridItem id="default"><strong>Normal</strong></VAutoLayoutGridItem>
<VAutoLayoutGridItem id="selected" selected><strong>Selecionado</strong></VAutoLayoutGridItem>
<VAutoLayoutGridItem id="dragging" dragging><strong>A arrastar</strong></VAutoLayoutGridItem>
<VAutoLayoutGridItem id="disabled" disabled><strong>Desativado</strong></VAutoLayoutGridItem>
</VAutoLayoutGrid>
</template>Acessibilidade
- Keyboard navigation (Tab, Arrow keys) — navegação sequencial e por setas (roving tabindex) entre itens.
- Semantic list/grid structure — usar
<ul>/<li>ourole="grid"+role="gridcell"conforme interactividade. - Proper focus indicators — anel de foco visível via
:focus-visible, nunca removido sem substituto. - ARIA roles and labels —
aria-labelda grelha earia-selectednos itens seleccionáveis. - Supports reduced motion preference —
prefers-reduced-motion: reducedesliga reflow e elevações. - Sufficient color contrast — texto/meta dos cartões dentro do mínimo WCAG AA.
- Works with screen readers — ordem de leitura = ordem visual/DOM; anunciar mudanças de layout quando relevantes.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
minItemWidth | number | 280 | Largura mínima (px) de cada coluna; define quantas colunas cabem. |
gap | number | — | Espaçamento (px) entre linhas e colunas. Se omitido, `size` decide. |
rowGap | number | — | — |
columnGap | number | — | — |
behavior | VAutoLayoutGridBehavior | "auto-fit" | — |
size | VAutoLayoutGridSize | "medium" | — |
selectable | boolean | false | — |
ariaLabel | string | — | — |
Events
Não emite eventos.
Slots
| Slot | Props do slot |
|---|---|
#default | — |
#drop-preview | — |
Fonte: src/components/grid/VAutoLayoutGrid/VAutoLayoutGrid.vue · tipos: src/components/grid/VAutoLayoutGrid/VAutoLayoutGrid.types.ts