Layout e grids
VDashboardColumn
`VDashboardColumn` é o primitivo de coluna do dashboard: empilha widgets na vertical com cabeçalho opcional (ícone, título, grip e menu …).
<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).
<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
<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
<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
<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
<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
<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
<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
<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
<script setup lang="ts">
import { VDashboardColumn } from 'vueui-nova-kit'
</script>
<template>
<VDashboardColumn
title="Visão geral"
variant="collapsible"
menu
draggable />
</template>Acessibilidade
- Keyboard navigation (Tab, Arrow keys) — foco sequencial e por setas entre coluna e widgets.
- Resizable via keyboard (Arrow keys) — handle de resize operável por setas com foco visível.
- Proper ARIA labels and roles —
role="region"/aria-labelda coluna,aria-grabbed/aria-dropeffectou padrão DnD equivalente. - Drop zone announced to screen readers — zona de largada anunciada via
aria-live. - Focus visible on interactive elements — anel de foco em header, handles, botão de collapse e
+. - Works with screen readers (NVDA, VoiceOver) — compatível com leitores citados.
- Maintains logical tab order — ordem de tab = ordem visual (header → widgets → handles).
- Sufficient color contrast for indicators — indicadores de drop/resize/selecção com contraste suficiente.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
title | string | — | Título do cabeçalho da coluna (também é o nome acessível da região). |
icon | IconifyIcon | — | Ícone opcional antes do título. |
variant | VDashboardColumnVariant | "fixed" | Comportamento: `fixed` (largura em px), `fluid` (preenche o espaço), `collapsible` (vira um trilho) ou `sticky` (fica visível na rolagem). |
size | VDashboardColumnSize | "medium" | Largura predefinida: `narrow` 240px, `medium` 300px, `wide` 400px. |
width | number | — | Largura em px (`v-model:width`). Sobrepõe `size`; atualizada ao redimensionar. |
minWidth | number | 200 | Largura mínima ao redimensionar (px). |
maxWidth | number | 560 | Largura máxima ao redimensionar (px). |
resizable | boolean | false | Mostra a borda de redimensionamento (ponteiro e setas do teclado). |
collapsed | boolean | false | Estado recolhido (`v-model:collapsed`). Só tem efeito com `variant="collapsible"`. |
stickyTop | number | 0 | Distância do topo (px) quando `variant="sticky"`. |
draggable | boolean | false | Mostra o grip de arrastar no cabeçalho (para builders). |
menu | boolean | false | Mostra o botão de mais ações (…) no cabeçalho. |
droppable | boolean | false | Aceita widgets arrastados (HTML5 drag and drop) e revela a zona de largada. |
dropTarget | boolean | false | Força a zona de largada visível (pré-visualização de inserção). |
dropLabel | string | "Solte o widget aqui" | Texto da zona de largada. |
addLabel | string | "Adicionar widget" | Rótulo do botão de adicionar na zona de largada. Vazio esconde o botão. |
selected | boolean | false | Estado selecionado (anel de destaque). |
disabled | boolean | false | Desativa interação. |
ariaLabel | string | — | Nome acessível quando não há título. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:collapsed | collapsed: boolean | — |
@update:width | width: number | — |
@drop | event: DragEvent | Um item foi solto na coluna. |
@add | — | O botão de adicionar da zona de largada foi acionado. |
@menu | event: MouseEvent | O botão de mais ações (…) foi acionado. |
Slots
| Slot | Props do slot |
|---|---|
#header | — |
#header-actions | — |
#default | — |
#footer | — |
Fonte: src/components/grid/VDashboardColumn/VDashboardColumn.vue · tipos: src/components/grid/VDashboardColumn/VDashboardColumn.types.ts