07 · Métricas e gráficos

KpiCard

trend up/down/flat · delta_tone · color (7) · layout stack/inline · icon_tone · live · sparkline

Card de indicador do exemplo: número grande tabular, unidade em subtle, delta colorido no rodapé.

Números contando

Faturamento R$↗
8,8% vs outubro
Pedidos ↗
12% vs outubro
Cancelamentos ↘
0,4 pt vs outubro
Ticket médio R$→
0% vs outubro
.heex
<div class="grid grid-cols-4 gap-3">
  <.kpi_card variant="badge" color="neutral" label="Faturamento" prefix="R$" count={184320} delta="8,8%" compare="vs outubro" trend="up" />
  <.kpi_card variant="badge" color="neutral" label="Pedidos" count={1096} delta="12%" compare="vs outubro" trend="up" />
  <.kpi_card variant="badge" color="neutral" label="Cancelamentos" count={23} delta="0,4 pt" compare="vs outubro" trend="down" />
  <.kpi_card variant="badge" color="neutral" label="Ticket médio" prefix="R$" count={168} delta="0%" compare="vs outubro" trend="flat" />
</div>

trend up/down/flat · layout stack/inline · icon_tone

Recebido R$k↗
8,8% vs outubro
Em atraso R$k↘
8,8% vs outubro
Estoque baixo →
8,8% vs outubro
Clientes ↗
8,8% vs outubro
.heex
<div class="grid grid-cols-4 gap-3">
  <.kpi_card variant="badge" color="neutral" layout="stack" icon_tone="pos" label="Recebido" prefix="R$" count={42} unit="k" delta="8,8%" compare="vs outubro" trend="up">
    <:icon><.icon name="wallet" size="md" /></:icon>
  </.kpi_card>
  <.kpi_card variant="badge" color="neutral" layout="inline" icon_tone="neg" label="Em atraso" prefix="R$" count={8} unit="k" delta="8,8%" compare="vs outubro" trend="down">
    <:icon><.icon name="alert" size="md" /></:icon>
  </.kpi_card>
  <.kpi_card variant="badge" color="neutral" layout="inline" icon_tone="warn" label="Estoque baixo" count={12} delta="8,8%" compare="vs outubro" trend="flat">
    <:icon><.icon name="layers" size="md" /></:icon>
  </.kpi_card>
  <.kpi_card variant="badge" color="neutral" layout="stack" icon_tone="info" label="Clientes" count={312} delta="8,8%" compare="vs outubro" trend="up">
    <:icon><.icon name="users" size="md" /></:icon>
  </.kpi_card>
</div>

Valores da API que completam a paridade

+8,8%delta_tone=success
−2,1%delta_tone=error
FaturamentoR$ 184 mil
color=primary
FaturamentoR$ 184 mil
color=secondary
FaturamentoR$ 184 mil
color=success
FaturamentoR$ 184 mil
color=warning
FaturamentoR$ 184 mil
color=error
.heex
<div class="grid grid-cols-7 gap-3.5">
  <div class="flex flex-col items-start gap-1.5"><.badge canvas color="success">+8,8%</.badge><span class="font-mono text-[11px] text-muted">delta_tone=success</span></div>
  <div class="flex flex-col items-start gap-1.5"><.badge canvas color="error">−2,1%</.badge><span class="font-mono text-[11px] text-muted">delta_tone=error</span></div>
  <div :for={c <- ~w(primary secondary success warning error)} class="flex flex-col items-start gap-1.5">
    <.card variant="soft" color={c} gradient={nil} style="min-height:0;width:100%"><span>Faturamento</span><b style="font-size:20px">R$ 184 mil</b></.card>
    <span class="font-mono text-[11px] text-muted">color={c}</span>
  </div>
</div>

Uso

<.kpi_card label="MRR" value={184_320} unit="$" delta={8.8} compare="vs $169,460 in Sep" live spark={@mrr_series} />

Regras

  • A cor do delta segue o significado, não a direção: churn subir é neg (▲ vermelho).
  • Sparkline ocupa ~46% à direita com degradê accent-soft; ponto final com halo.
  • Botão redondo teal (→) leva ao relatório; é o único elemento circular do card.

Referência da API

Todos os function components, atributos, valores e slots que este componente cobre.

Indicator card: a big tabular figure, its unit in subtle and a coloured delta in the footer.

<.kpi_card label="MRR" value="184,320" prefix="$" delta="8.8%" compare="vs $169,460 in Sep"
  live spark={@mrr_series} open_label="Open" on_open="open_report" />

<.kpi_card label="Churn rate" value="2.1" unit="%" delta="0.4 pts" trend="up" delta_tone="error" />

The colour of the delta follows the meaning, not the direction: churn going up is error (a red arrow pointing up). trend draws the arrow (up, down, flat), delta_tone colours it and defaults from trend (up success, down error, flat neutral).

Variants

  • canvas (default): the reference card. The sparkline sits at the right (spark), the delta is a coloured figure with a small triangle and the arrow an icon.
  • badge: the compact card of the dashboards, with the delta in a badge and the arrow as a glyph (↗, ↘, →); pair it with count for a figure that counts up (CSS only).

With an <:icon>, layout="stack" puts the icon chip before the label and "inline" puts it beside the label and the figure.

The sparkline is drawn on the server (see LedgerUI.Components.Sparkline). The gradient of its fill takes its id from id (derived from the card's content when not given). Styled only with Tailwind utilities; the figure fades in once on mount.

color is kept for the API of the canvas; the card follows the accent (its arrow, sparkline and round button), as the design does.

<.kpi_card>

Attr Type Default Values / notes
id :string nil
label :string nil
value :string nil The figure, already formatted.
prefix :string nil A small prefix before the figure ($, R$).
unit :string nil A smaller suffix beside the figure (mil, %, dias).
delta :string nil The change since the last period, already formatted.
compare :string nil What the change is measured against (vs Sep).
trend :string "up" up, down, flat
delta_tone :string nil nil, success, error, neutral
spark :list [] Numbers for the sparkline.
color :string "primary" neutral, primary, secondary, info, success, warning, error - Kept for the canvas API; the card always follows the accent.
variant :string "canvas" canvas, badge
layout :string "inline" stack, inline
count :integer nil badge variant: the figure counts up to this number, in CSS.
progress :integer nil 0 to 100: a meter under the figure, in place of the sparkline.
caption :string nil A faint line under the figure or the meter.
icon_tone :string "acc" acc, pos, neg, warn, info
value_id :string nil The id of the figure element.
gap :boolean true
loading :boolean false
live :boolean false A Live chip beside the label.
live_label :string "Live"
open_label :string nil aria-label of the round button at the footer's right; no button without it.
on_open :any nil Event name or %JS{} of the round button.
class :any nil

Any other HTML/phx attribute goes to the root element.

Slots:

  • <:footer> - A link or caption in the card's footer, after the delta and the comparison.
  • <:icon> - An icon shown in a tinted chip before the label.