Layout e grids

VDashboardRow

Componente7 exemplos14 propsA2UI · DashboardRow

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

Importação
<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.

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

  1. Supports keyboard navigation — filhos focáveis alcançáveis por Tab.
  2. Maintains logical tab order — ordem de tab = ordem visual da fileira.
  3. Visible focus indicator — anel de foco visível via :focus-visible.
  4. Works with screen readers — ordem de leitura = ordem DOM/visual.
  5. Uses semantic container (div/section) — <div> ou <section> com heading quando a fileira for secção.
  6. Sufficient color contrast for interactive states — estados Hover/Selected/Drag target com contraste suficiente.
  7. Responsive and readable at 200% zoom — legível e utilizável com zoom de 200% (wrap evita corte horizontal).

Props

PropTipoDefaultDescrição
variantVDashboardRowVariant"standard"Layout: `standard` (espaço uniforme), `dense` (gap compacto), `split` (conteúdo à esquerda, ações à direita) ou `wrap` (quebra em telas pequenas).
gapVDashboardRowGap—Espaço entre os itens: `compact` 8px, `medium` 16px, `spacious` 24px. `dense` força `compact`.
alignVDashboardRowAlign—Alinhamento vertical dos itens (`align-items`).
justifyVDashboardRowJustify—Distribuição horizontal (`justify-content`). Default `between` em `split`, `start` nos demais.
wrapbooleanfalseForça a quebra de linha. `variant="wrap"` já liga a quebra.
dividerbooleanfalseExibe o separador inferior opcional.
titlestring—Título da fileira (vira heading quando `as="section"`).
subtitlestring—Subtítulo exibido sob o título.
asVDashboardRowTag"div"Elemento raiz. `section` usa o título como nome acessível.
selectablebooleanfalseTorna a fileira selecionável (foco, Enter/Espaço e clique alternam `selected`).
selectedbooleanfalseEstado selecionado (`v-model:selected`).
dropTargetbooleanfalseMostra o indicador tracejado de largada (drag target).
disabledbooleanfalseDesativa hover, seleção e interação.
ariaLabelstring—Nome acessível quando não há título.

Events

EventoPayloadDescrição
@update:selectedselected: boolean—

Slots

SlotProps do slot
#title—
#default—
#actions—

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