Célula de dashboard para KPIs, gráficos, listas e chamadas, com cabeçalho, rodapé e estados. Célula de dashboard: KPI (value/delta), lista (items), CTA (actionLabel → action) ou placeholder (addAction). Navegação só por action (footerAction), nunca por href.
Componente da lib: VWidgetCell. Valor ligado em selected (vira v-model). Ver na galeria. Actions: action ← actionaddAction ← adddismissAction ← closemenuAction ← menufooterAction ← footer.
| Prop | Tipo | Padrão | Descrição |
|---|
title | string · dinâmico | | Título do cabeçalho (nome acessível da célula). |
subtitle | string · dinâmico | | Subtítulo sob o título (ex.: "Este mês"). |
icon | IconName | | Ícone do cabeçalho, num tile tingido. |
variant | "chart" | "stat" | "list" | "action" | "placeholder" | "stat" | Conteúdo: stat (KPI), chart (mini gráfico no slot), list (lista compacta), action (CTA) ou placeholder (estado vazio de builders). |
size | "wide" | "medium" | "small" | "large" | "medium" | Tamanho de referência: small 280×180, medium 320×220, large 360×280, wide 560×220. |
stretch | boolean · dinâmico | false | Ocupa toda a largura da célula do grid em vez da largura de referência. |
value | string · dinâmico | | Valor do KPI (variant="stat"). |
delta | string · dinâmico | | Variação do KPI, ex.: +12%. A tendência é inferida do sinal quando trend é omitido. |
trend | "neutral" | "up" | "down" | | |
deltaCaption | string · dinâmico | | Texto após a variação (ex.: "vs. mês passado"). |
items | object[] | DataBinding | | Itens da lista (variant="list"). |
description | string · dinâmico | | Descrição da chamada (variant="action" e placeholder). |
actionLabel | string · dinâmico | | Rótulo do botão de ação (action) ou do tile de adicionar (placeholder). |
footerLabel | string · dinâmico | | Texto do link do rodapé (ex.: "Ver detalhes"). |
updatedLabel | string · dinâmico | | Metadado do rodapé (ex.: "Atualizado há 2 min"). |
menu | boolean · dinâmico | false | Mostra o botão de mais ações (…). |
closable | boolean · dinâmico | false | Mostra o botão de fechar (×). |
selectable | boolean · dinâmico | false | Permite selecionar a célula (clique na superfície ou botão de seleção com aria-pressed). |
loading | boolean · dinâmico | false | Carregando novos dados: spinner, shimmer e aria-busy. |
disabled | boolean · dinâmico | false | Desativa a célula. |
selected | boolean · dinâmico | | Valor em duas vias. Use {"@path": "/..."}: o renderer escreve no data model a cada update:selected (local; só vai ao agente numa action). |
child | Child | | Conteúdo do slot default (ID de um componente). |
actions | filhos (lista ou template) | | Componentes do slot actions (tipicamente Buttons). |
footer | filhos (lista ou template) | | Componentes do slot footer (tipicamente Buttons). |
action | action | | Disparada no evento Vue action. |
addAction | action | | Disparada no evento Vue add. |
dismissAction | action | | Disparada no evento Vue close. |
menuAction | action | | Disparada no evento Vue menu. |
footerAction | action | | Disparada no evento Vue footer. |
weight | number (flex) | | |