Layout e grids

VAutoLayoutGrid

Componente10 exemplos8 propsA2UI · AutoLayoutGrid

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

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

Uso

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

  1. Keyboard navigation (Tab, Arrow keys) — navegação sequencial e por setas (roving tabindex) entre itens.
  2. Semantic list/grid structure — usar <ul>/<li> ou role="grid" + role="gridcell" conforme interactividade.
  3. Proper focus indicators — anel de foco visível via :focus-visible, nunca removido sem substituto.
  4. ARIA roles and labels — aria-label da grelha e aria-selected nos itens seleccionáveis.
  5. Supports reduced motion preference — prefers-reduced-motion: reduce desliga reflow e elevações.
  6. Sufficient color contrast — texto/meta dos cartões dentro do mínimo WCAG AA.
  7. Works with screen readers — ordem de leitura = ordem visual/DOM; anunciar mudanças de layout quando relevantes.

Props

PropTipoDefaultDescrição
minItemWidthnumber280Largura mínima (px) de cada coluna; define quantas colunas cabem.
gapnumber—Espaçamento (px) entre linhas e colunas. Se omitido, `size` decide.
rowGapnumber——
columnGapnumber——
behaviorVAutoLayoutGridBehavior"auto-fit"—
sizeVAutoLayoutGridSize"medium"—
selectablebooleanfalse—
ariaLabelstring——

Events

Não emite eventos.

Slots

SlotProps do slot
#default—
#drop-preview—

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