Layout e grids

VDashboardColumn

Componente8 exemplos19 propsA2UI · DashboardColumn

`VDashboardColumn` é o primitivo de coluna do dashboard: empilha widgets na vertical com cabeçalho opcional (ícone, título, grip e menu …).

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

Uso

Coloque as colunas lado a lado num container flex (com flex-wrap para telas estreitas). variant="fluid" divide o espaço; fixed usa size ou v-model:width. Com resizable, a borda direita é um separador operável por ponteiro e por setas (Shift acelera, Home/End vão aos limites). variant="collapsible" + v-model:collapsed mostra o botão com aria-expanded. Com droppable, arrastar sobre a coluna revela a zona de largada e soltar emite drop (anunciado num aria-live).

Exemplo
<script setup lang="ts">
import { ref } from 'vue'
import { VDashboardColumn, VStatCard } from 'vueui-nova-kit'

const collapsed = ref(false)
</script>

<template>
  <div style="display: flex; flex-wrap: wrap; gap: 16px; align-items: flex-start">
    <VDashboardColumn title="Visão geral" variant="collapsible" v-model:collapsed="collapsed" menu>
      <VStatCard label="Usuários" value="12.486" delta="+12%" size="sm" />
      <VStatCard label="Sessões" value="8.421" delta="+8%" size="sm" />
    </VDashboardColumn>
    <VDashboardColumn title="Conversões" variant="fluid" droppable @drop="onDrop">
      <VStatCard label="Conversão" value="3,6%" delta="+0,8%" size="sm" />
    </VDashboardColumn>
  </div>
</template>

Playground

Os controles abaixo são gerados a partir das props declaradas em VDashboardColumn.types.ts; o código acompanha cada mudança.

Exemplos

Variantes, tamanhos e estados, extraídos das stories da biblioteca.

Default

Coluna fixed de 300px com cabeçalho (grip, título e menu …) e dois widgets empilhados. Use Controls para trocar variant, size e os estados.

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

const args = {
  title: 'Visão geral',
  variant: 'fixed',
  size: 'medium',
  menu: true,
  draggable: true,
  resizable: false,
  dropTarget: false,
  selected: false,
  disabled: false
}
const usersIcon = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M8 14H10C13.3137 14 16 16.6863 16 20C16 20.5523 15.5523 21 15 21H3C2.44772 21 2 20.5523 2 20C2 16.6863 4.68629 14 8 14ZM9 4C10.6569 4 12 5.34315 12 7C12 8.65685 10.6569 10 9 10C7.34315 10 6 8.65685 6 7C6 5.34315 7.34315 4 9 4ZM16 4C17.6569 4 19 5.34315 19 7C19 8.65685 17.6569 10 16 10M18.3333 14.4713C20.554 15.409 22 17.589 22 20C22 20.5523 21.5523 21 21 21\'/>'
}
const arrowUpRightIcon = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 6H17.5C17.77614 6 18 6.22386 18 6.5V18M7.2 16.8L17.4 6.6\'/>'
}
</script>

<template>
  <VDashboardColumn v-bind="args">
    <VStatCard label="Usuários" value="12.486" delta="+12%" delta-caption="vs. mês passado" :icon="usersIcon" size="sm" variant="elevated" />
    <VStatCard label="Sessões" value="8.421" delta="+8%" delta-caption="vs. mês passado" :icon="arrowUpRightIcon" size="sm" variant="elevated" />
  </VDashboardColumn>
</template>

In Context

Dashboard real com três colunas lado a lado (Visão geral, Engajamento e Conversões). As colunas fluid dividem o espaço; em telas estreitas a linha quebra e cada coluna ocupa a largura toda.

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

const usersIcon = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M8 14H10C13.3137 14 16 16.6863 16 20C16 20.5523 15.5523 21 15 21H3C2.44772 21 2 20.5523 2 20C2 16.6863 4.68629 14 8 14ZM9 4C10.6569 4 12 5.34315 12 7C12 8.65685 10.6569 10 9 10C7.34315 10 6 8.65685 6 7C6 5.34315 7.34315 4 9 4ZM16 4C17.6569 4 19 5.34315 19 7C19 8.65685 17.6569 10 16 10M18.3333 14.4713C20.554 15.409 22 17.589 22 20C22 20.5523 21.5523 21 21 21\'/>'
}
const arrowUpRightIcon = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M6 6H17.5C17.77614 6 18 6.22386 18 6.5V18M7.2 16.8L17.4 6.6\'/>'
}
const checkIcon = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 12L9.66667 17L19 7\'/>'
}
const pages = [
  {
    label: '/dashboard',
    value: 42
  },
  {
    label: '/produtos',
    value: 28
  },
  {
    label: '/docs',
    value: 18
  }
]
</script>

<template>
  <div style="display:flex;flex-wrap:wrap;gap:16px;align-items:flex-start">
    <VDashboardColumn variant="fluid" title="Visão geral" draggable menu style="min-width:240px">
      <VStatCard label="Usuários" value="12.486" delta="+12%" :icon="usersIcon" size="sm" variant="elevated" />
      <VStatCard label="Sessões" value="8.421" delta="+8%" :icon="arrowUpRightIcon" size="sm" variant="elevated" />
    </VDashboardColumn>
    <VDashboardColumn variant="fluid" title="Engajamento" draggable menu style="min-width:240px">
      <VStatCard label="Ativos por dia" value="4.329" delta="+16%" :icon="usersIcon" size="sm" variant="elevated" />
      <VBarList :items="pages" aria-label="Páginas mais vistas" />
    </VDashboardColumn>
    <VDashboardColumn variant="fluid" title="Conversões" draggable menu style="min-width:240px">
      <VStatCard label="Conversão" value="3,6%" delta="+0,8%" :icon="checkIcon" size="sm" variant="elevated" />
      <VStatCard label="Cadastros" value="892" delta="+20%" :icon="usersIcon" size="sm" variant="elevated" />
    </VDashboardColumn>
  </div>
</template>

Variants

fixed (largura em px), fluid (preenche o espaço), collapsible (recolhe para um trilho pelo botão do cabeçalho, com aria-expanded) e sticky (fica visível na rolagem, com topo destacado).

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

const block = 'height:72px;border-radius:10px;background:var(--v-color-surface);border:1px solid var(--v-color-border)'
const collapsed = ref(false)
</script>

<template>
  <div style="display:flex;flex-wrap:wrap;gap:16px;align-items:flex-start">
    <VDashboardColumn data-test-id="docs-dashboard-column-variant-fixed" variant="fixed" size="narrow" title="Fixa"><div :style="block" /><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-variant-fluid" variant="fluid" title="Fluida" style="min-width:220px"><div :style="block" /><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-variant-collapsible" variant="collapsible" size="narrow" title="Recolhível" v-model:collapsed="collapsed"><div :style="block" /><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-variant-sticky" variant="sticky" size="narrow" title="Fixa no topo"><div :style="block" /><div :style="block" /></VDashboardColumn>
  </div>
</template>

Sizes

Larguras predefinidas: narrow (240px), medium (300px, padrão) e wide (400px). Em containers menores a coluna nunca passa de 100% da largura.

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

const block = 'height:72px;border-radius:10px;background:var(--v-color-surface);border:1px solid var(--v-color-border)'
const sizes = [
  'narrow',
  'medium',
  'wide'
]
</script>

<template>
  <div style="display:flex;flex-wrap:wrap;gap:16px;align-items:flex-start">
    <VDashboardColumn v-for="s in sizes" :key="s" :data-test-id="'docs-dashboard-column-size-' + s" :size="s" :title="s"><div :style="block" /></VDashboardColumn>
  </div>
</template>

States

Estados: padrão, zona de largada (dropTarget, com botão +), selecionada, redimensionável (foque a borda direita e use as setas; Shift acelera, Home/End vão aos limites), recolhida e desativada.

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

const block = 'height:72px;border-radius:10px;background:var(--v-color-surface);border:1px solid var(--v-color-border)'
const width = ref(260)
</script>

<template>
  <div style="display:flex;flex-wrap:wrap;gap:16px;align-items:flex-start">
    <VDashboardColumn data-test-id="docs-dashboard-column-state-default" size="narrow" title="Padrão"><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-state-drop" size="narrow" title="Zona de largada" drop-target><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-state-selected" size="narrow" title="Selecionada" selected><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-state-resizing" v-model:width="width" :min-width="200" :max-width="360" resizable :title="'Largura ' + width + 'px'"><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-state-collapsed" variant="collapsible" collapsed title="Recolhida"><div :style="block" /></VDashboardColumn>
    <VDashboardColumn data-test-id="docs-dashboard-column-state-disabled" size="narrow" title="Desativada" disabled><div :style="block" /></VDashboardColumn>
  </div>
</template>

Drag And Drop

Com droppable, arrastar um elemento (HTML5 drag and drop) sobre a coluna revela a zona de largada; ao soltar, a coluna emite drop e anuncia a inserção num aria-live. Aqui o widget arrastado é movido entre as colunas.

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

const cols = ref({
  a: [
    'Receita',
    'Pedidos'
  ],
  b: [
    'Retenção'
  ]
})
const block = 'height:72px;border-radius:10px;background:var(--v-color-surface);border:1px solid var(--v-color-border)'
const start = (from, item, e) => {
        dragging = { from, item };
        e.dataTransfer?.setData("text/plain", item);
      }
const drop = (to) => {
        if (!dragging || dragging.from === to) return;
        cols.value[dragging.from] = cols.value[dragging.from].filter((i) => i !== dragging.item);
        cols.value[to] = [...cols.value[to], dragging.item];
        dragging = null;
      }
</script>

<template>
  <div style="display:flex;flex-wrap:wrap;gap:16px;align-items:flex-start">
    <VDashboardColumn v-for="(items, key) in cols" :key="key" droppable size="narrow" :title="key === 'a' ? 'Financeiro' : 'Clientes'" :add-label="''" @drop="drop(key)">
      <div v-for="i in items" :key="i" draggable="true" @dragstart="start(key, i, $event)" style="padding:14px;border-radius:10px;border:1px solid var(--v-color-border);background:var(--v-color-surface);cursor:grab">{{ i }}</div>
    </VDashboardColumn>
  </div>
</template>

Wide

Tamanho wide (400px).

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

<template>
  <VDashboardColumn title="Visão geral" size="wide" menu draggable />
</template>

Collapsible

Variante collapsible: o botão do cabeçalho alterna o trilho recolhido (v-model:collapsed).

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

<template>
  <VDashboardColumn
    title="Visão geral"
    variant="collapsible"
    menu
    draggable />
</template>

Acessibilidade

  1. Keyboard navigation (Tab, Arrow keys) — foco sequencial e por setas entre coluna e widgets.
  2. Resizable via keyboard (Arrow keys) — handle de resize operável por setas com foco visível.
  3. Proper ARIA labels and roles — role="region"/aria-label da coluna, aria-grabbed/aria-dropeffect ou padrão DnD equivalente.
  4. Drop zone announced to screen readers — zona de largada anunciada via aria-live.
  5. Focus visible on interactive elements — anel de foco em header, handles, botão de collapse e +.
  6. Works with screen readers (NVDA, VoiceOver) — compatível com leitores citados.
  7. Maintains logical tab order — ordem de tab = ordem visual (header → widgets → handles).
  8. Sufficient color contrast for indicators — indicadores de drop/resize/selecção com contraste suficiente.

Props

PropTipoDefaultDescrição
titlestring—Título do cabeçalho da coluna (também é o nome acessível da região).
iconIconifyIcon—Ícone opcional antes do título.
variantVDashboardColumnVariant"fixed"Comportamento: `fixed` (largura em px), `fluid` (preenche o espaço), `collapsible` (vira um trilho) ou `sticky` (fica visível na rolagem).
sizeVDashboardColumnSize"medium"Largura predefinida: `narrow` 240px, `medium` 300px, `wide` 400px.
widthnumber—Largura em px (`v-model:width`). Sobrepõe `size`; atualizada ao redimensionar.
minWidthnumber200Largura mínima ao redimensionar (px).
maxWidthnumber560Largura máxima ao redimensionar (px).
resizablebooleanfalseMostra a borda de redimensionamento (ponteiro e setas do teclado).
collapsedbooleanfalseEstado recolhido (`v-model:collapsed`). Só tem efeito com `variant="collapsible"`.
stickyTopnumber0Distância do topo (px) quando `variant="sticky"`.
draggablebooleanfalseMostra o grip de arrastar no cabeçalho (para builders).
menubooleanfalseMostra o botão de mais ações (…) no cabeçalho.
droppablebooleanfalseAceita widgets arrastados (HTML5 drag and drop) e revela a zona de largada.
dropTargetbooleanfalseForça a zona de largada visível (pré-visualização de inserção).
dropLabelstring"Solte o widget aqui"Texto da zona de largada.
addLabelstring"Adicionar widget"Rótulo do botão de adicionar na zona de largada. Vazio esconde o botão.
selectedbooleanfalseEstado selecionado (anel de destaque).
disabledbooleanfalseDesativa interação.
ariaLabelstring—Nome acessível quando não há título.

Events

EventoPayloadDescrição
@update:collapsedcollapsed: boolean—
@update:widthwidth: number—
@dropevent: DragEventUm item foi solto na coluna.
@add—O botão de adicionar da zona de largada foi acionado.
@menuevent: MouseEventO botão de mais ações (…) foi acionado.

Slots

SlotProps do slot
#header—
#header-actions—
#default—
#footer—

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