Layout e grids
VDashboardRow
`VDashboardRow` é o primitivo de fileira do dashboard: alinha, distribui e espaça filhos arbitrários (KPIs, filtros, ações) e quebra a linha em telas pequenas.
<script setup lang="ts">
import { VDashboardRow } from 'vueui-nova-kit'
</script>Uso
Use variant="split" com title/subtitle e o slot actions para cabeçalhos de seção, e variant="wrap" (ou wrap) para fileiras de KPIs que devem quebrar em telas pequenas. as="section" transforma o título num h2 que nomeia a região. selectable + v-model:selected deixa a fileira alternável por clique, Enter ou Espaço (cliques em botões internos não alternam); dropTarget mostra o indicador de largada.
<script setup lang="ts">
import { VButton, VDashboardRow, VStatCard } from 'vueui-nova-kit'
</script>
<template>
<VDashboardRow as="section" variant="split" title="Análise do produto" subtitle="Últimos 30 dias" divider wrap>
<template #actions>
<VButton size="sm" variant="secondary">Filtros</VButton>
<VButton size="sm">Exportar</VButton>
</template>
</VDashboardRow>
<VDashboardRow variant="wrap" align="stretch" aria-label="Indicadores">
<VStatCard label="Usuários" value="12.568" delta="+12%" style="flex: 1 1 200px" />
<VStatCard label="Receita" value="R$ 28.430" delta="+16%" style="flex: 1 1 200px" />
</VDashboardRow>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VDashboardRow.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Cabeçalho de seção no padrão split: título e subtítulo à esquerda, ações (slot actions) à direita. Com wrap, as ações descem para a linha de baixo quando falta espaço.
Ver código
<script setup lang="ts">
import { VDashboardRow, VButton } from 'vueui-nova-kit'
const args = {
variant: 'split',
gap: 'medium',
title: 'Análise do produto',
subtitle: 'Desempenho e engajamento dos últimos 30 dias.',
wrap: true,
divider: false
}
</script>
<template>
<VDashboardRow v-bind="args">
<template #actions>
<VButton size="sm" variant="secondary">Últimos 30 dias</VButton>
<VButton size="sm" variant="secondary">Filtros</VButton>
<VButton size="sm">Exportar</VButton>
</template>
</VDashboardRow>
</template>In Context
Header típico de dashboard: uma fileira split com divisor e, abaixo, uma fileira wrap com quatro VStatCard. Em telas estreitas os KPIs quebram para novas linhas sem rolagem horizontal.
Ver código
<script setup lang="ts">
import { VDashboardRow, VButton, VStatCard } from 'vueui-nova-kit'
const kpis = [
{
id: 'users',
label: 'Usuários',
value: '12.568',
delta: '+12%',
icon: {
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\'/>'
}
},
{
id: 'sessions',
label: 'Sessões ativas',
value: '4.320',
delta: '+8%',
icon: {
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\'/>'
}
},
{
id: 'conversion',
label: 'Conversão',
value: '3,24%',
delta: '+2%',
icon: {
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\'/>'
}
},
{
id: 'revenue',
label: 'Receita',
value: 'R$ 28.430',
delta: '+16%',
icon: {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 3L15 3C16.6569 3 18 4.3431 18 6L18 7C19.6569 7 21 8.3431 21 10L21 18C21 19.6569 19.6569 21 18 21L6 21C4.3431 21 3 19.6569 3 18L3 5C3 3.8954 3.8954 3 5 3ZM3 5C3 6.1046 3.8954 7 5 7L18 7M21 12L18 12C16.8954 12 16 12.8954 16 14C16 15.1046 16.8954 16 18 16L21 16\'/>'
}
}
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:16px">
<VDashboardRow as="section" variant="split" title="Análise do produto" subtitle="Desempenho e engajamento dos usuários." divider wrap>
<template #actions>
<VButton size="sm" variant="secondary">Filtros</VButton>
<VButton size="sm">Exportar</VButton>
</template>
</VDashboardRow>
<VDashboardRow variant="wrap" gap="medium" align="stretch" aria-label="Indicadores">
<VStatCard v-for="k in kpis" :key="k.id" :data-test-id="'v-dashboard-row-item-' + k.id" style="flex:1 1 200px" :label="k.label" :value="k.value" :delta="k.delta" delta-caption="vs. período anterior" :icon="k.icon" size="sm" variant="outlined" />
</VDashboardRow>
</div>
</template>Variants
As quatro variantes: standard (espaço uniforme), dense (gap compacto), split (conteúdo à esquerda e ações à direita) e wrap (quebra automática).
Ver código
<script setup lang="ts">
import { VDashboardRow, VButton } from 'vueui-nova-kit'
const tile = 'flex:1 1 140px;min-height:56px;padding:12px 14px;border-radius:12px;border:1px solid var(--v-color-border);background:var(--v-color-surface);font-size:13px;color:var(--v-color-text)'
const variants = [
'standard',
'dense',
'split',
'wrap'
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:20px">
<div v-for="v in variants" :key="v" :data-test-id="'docs-dashboard-row-variant-' + v">
<p style="margin:0 0 6px;font-size:12px;color:var(--v-color-text-muted)">{{ v }}</p>
<VDashboardRow :variant="v" :aria-label="'Fileira ' + v">
<div v-for="n in (v === 'wrap' ? 6 : 4)" :key="n" :style="tile">Item {{ n }}</div>
<template v-if="v === 'split'" #actions><VButton size="sm" variant="secondary">Ações</VButton></template>
</VDashboardRow>
</div>
</div>
</template>Sizes
Espaçamento predefinido entre itens: compact (8px), medium (16px, padrão) e spacious (24px), todos da escala --v-space-*.
Ver código
<script setup lang="ts">
import { VDashboardRow } from 'vueui-nova-kit'
const tile = 'flex:1 1 140px;min-height:56px;padding:12px 14px;border-radius:12px;border:1px solid var(--v-color-border);background:var(--v-color-surface);font-size:13px;color:var(--v-color-text)'
const gaps = [
'compact',
'medium',
'spacious'
]
</script>
<template>
<div style="display:flex;flex-direction:column;gap:20px">
<div v-for="g in gaps" :key="g" :data-test-id="'docs-dashboard-row-size-' + g">
<p style="margin:0 0 6px;font-size:12px;color:var(--v-color-text-muted)">{{ g }}</p>
<VDashboardRow :gap="g" :aria-label="'Gap ' + g">
<div v-for="n in 4" :key="n" :style="tile">Item {{ n }}</div>
</VDashboardRow>
</div>
</div>
</template>States
Estados de fileiras interativas: padrão, selecionada (selectable + v-model:selected, alterna com clique, Enter ou Espaço), alvo de largada (dropTarget, indicador tracejado) e desativada (disabled). Passe o mouse sobre a primeira para ver o realce de hover.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDashboardRow } from 'vueui-nova-kit'
const tile = 'flex:1 1 140px;min-height:56px;padding:12px 14px;border-radius:12px;border:1px solid var(--v-color-border);background:var(--v-color-surface);font-size:13px;color:var(--v-color-text)'
const selected = ref(true)
const hover = ref(false)
</script>
<template>
<div style="display:flex;flex-direction:column;gap:16px">
<VDashboardRow data-test-id="docs-dashboard-row-state-default" selectable v-model:selected="hover" title="Padrão e hover" gap="compact">
<div v-for="n in 3" :key="n" :style="tile">Item {{ n }}</div>
</VDashboardRow>
<VDashboardRow data-test-id="docs-dashboard-row-state-selected" selectable v-model:selected="selected" title="Selecionada" gap="compact">
<div v-for="n in 3" :key="n" :style="tile">Item {{ n }}</div>
</VDashboardRow>
<VDashboardRow data-test-id="docs-dashboard-row-state-drag-target" drop-target title="Alvo de largada" gap="compact">
<div v-for="n in 3" :key="n" :style="tile">Item {{ n }}</div>
</VDashboardRow>
<VDashboardRow data-test-id="docs-dashboard-row-state-disabled" disabled title="Desativada" gap="compact">
<div v-for="n in 3" :key="n" :style="tile">Item {{ n }}</div>
</VDashboardRow>
</div>
</template>Dense
Variante dense: força o gap compact para layouts apertados.
Ver código
<script setup lang="ts">
import { VDashboardRow } from 'vueui-nova-kit'
</script>
<template>
<VDashboardRow variant="dense" gap="medium" title="Filtros rápidos" wrap />
</template>With Divider
Separador inferior opcional (divider) para marcar o fim do cabeçalho de seção.
Ver código
<script setup lang="ts">
import { VDashboardRow } from 'vueui-nova-kit'
</script>
<template>
<VDashboardRow
variant="split"
gap="medium"
title="Análise do produto"
subtitle="Desempenho e engajamento dos últimos 30 dias."
wrap
divider />
</template>Acessibilidade
- Supports keyboard navigation — filhos focáveis alcançáveis por Tab.
- Maintains logical tab order — ordem de tab = ordem visual da fileira.
- Visible focus indicator — anel de foco visível via
:focus-visible. - Works with screen readers — ordem de leitura = ordem DOM/visual.
- Uses semantic container (div/section) —
<div>ou<section>com heading quando a fileira for secção. - Sufficient color contrast for interactive states — estados Hover/Selected/Drag target com contraste suficiente.
- Responsive and readable at 200% zoom — legível e utilizável com zoom de 200% (wrap evita corte horizontal).
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
variant | VDashboardRowVariant | "standard" | Layout: `standard` (espaço uniforme), `dense` (gap compacto), `split` (conteúdo à esquerda, ações à direita) ou `wrap` (quebra em telas pequenas). |
gap | VDashboardRowGap | — | Espaço entre os itens: `compact` 8px, `medium` 16px, `spacious` 24px. `dense` força `compact`. |
align | VDashboardRowAlign | — | Alinhamento vertical dos itens (`align-items`). |
justify | VDashboardRowJustify | — | Distribuição horizontal (`justify-content`). Default `between` em `split`, `start` nos demais. |
wrap | boolean | false | Força a quebra de linha. `variant="wrap"` já liga a quebra. |
divider | boolean | false | Exibe o separador inferior opcional. |
title | string | — | Título da fileira (vira heading quando `as="section"`). |
subtitle | string | — | Subtítulo exibido sob o título. |
as | VDashboardRowTag | "div" | Elemento raiz. `section` usa o título como nome acessível. |
selectable | boolean | false | Torna a fileira selecionável (foco, Enter/Espaço e clique alternam `selected`). |
selected | boolean | false | Estado selecionado (`v-model:selected`). |
dropTarget | boolean | false | Mostra o indicador tracejado de largada (drag target). |
disabled | boolean | false | Desativa hover, seleção e interação. |
ariaLabel | string | — | Nome acessível quando não há título. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:selected | selected: boolean | — |
Slots
| Slot | Props do slot |
|---|---|
#title | — |
#default | — |
#actions | — |
Fonte: src/components/grid/VDashboardRow/VDashboardRow.vue · tipos: src/components/grid/VDashboardRow/VDashboardRow.types.ts