Skip to Content
Componentes

KPIs y métricas

Tarjetas, tiras y filas de indicadores, la estadística que elige su formato, comparativas de tiempo y resúmenes de informe.

Componentes para cuadros de mando: la cifra, su etiqueta y la tendencia.

NecesitasComponente
Una cifra destacada con icono, color y tendenciaDnzKpiCard
Varias tarjetas KPI en una rejilla que se adapta al anchoDnzKpiRow
Una tira horizontal compacta de númerosDnzKpiInline
Un grupo de estadísticas valor + etiqueta en una tarjetaDnzStatsDisplay
Un dato suelto con icono y contenido libre como valorDnzStatItem
Un KPI, una gráfica o una tabla según la forma del datoDnzDynamicStat
Tiempo previsto frente a tiempo real, con semáforoDnzTimeComparisonDisplay
Progreso real frente a progreso esperadoDnzProgressRhythm
Los totales de un informe de FlexDnzSummaryBar
Tarjeta pequeña icono + etiqueta + valorDnzCardKV, en Tarjetas y maquetación

Casi todos reciben la cifra ya formateada como texto ("1.250 €"): separador de miles, moneda y decimales los pones tú. Las variaciones (DeltaPercent) entran como decimal y DnzDynamicStat formatea según DnzDynamicStatFormatE.

DnzKpiCard y DnzKpiRow

Una fila de KPIs con una tarjeta normal con su variación, una compacta y una con degradado verde, y debajo una tira DnzKpiInline
1: el DnzKpiRow del ejemplo, con un DnzKpiCard normal, uno IsCompact y uno con HighlightColor Green. 2: un DnzKpiInline con Separator Pipe.

DnzKpiCard muestra título, cifra, icono, color, variación con flecha y un minigráfico opcional. Con más de una, colócalas en un DnzKpiRow, que reparte columnas según MinCardWidth (px, por defecto 220) y las baja de línea cuando no caben.

<DnzKpiRow MinCardWidth="260">
    <DnzKpiCard Title="Ventas del mes" Value=@($"€ {ventasMes:N0}") Icon="payments" Color="#1565c0" DeltaPercent=@variacionPct DeltaLabel="frente al mes anterior" />
    <DnzKpiCard IsCompact=true Title="Activas" Value=@activas.STR() Icon="check_circle" Color="#16a34a" />
    <DnzKpiCard Title="MRR" Value=@($"€ {mrr:N0}") Icon="trending_up" HighlightColor="DnzKpiCard.HighlightColorType.Green" />
</DnzKpiRow>

La variación se colorea sola (positivo verde, negativo rojo, cero gris). Si subir es malo (gastos, tiempos), pon DeltaInvertColors=true.

ParámetroTipoPor defectoQué hace
Titlestring""Etiqueta de la cifra.
Valuestring""La cifra, ya formateada.
Iconstring""Icono Material.
Colorstring"light-dark(black, var(--rz-text-color))"Color del texto y del icono.
Descriptionstring""Texto pequeño bajo la cifra.
IsCompactboolfalseVersión de una línea.
HighlightColorHighlightColorTypeUndefinedDegradado de fondo con texto en blanco: Auto, Red, Blue, Green, Yellow, Orange, Purple, Black, White, Gray.
DeltaPercentdecimal?nullPorcentaje de cambio, con flecha y signo.
DeltaLabelstring""Texto junto a la variación.
DeltaInvertColorsboolfalseInvierte verde y rojo.
TrendContentRenderFragmentMinigráfico de tendencia.
ButtonTextstring""Con texto, un botón de acción al pie.
ButtonIconstring""Icono del botón.
OnClickEventCallbackAl pulsar el botón.
Tooltipstring""Texto al pasar el ratón por la tarjeta.
VariantRadzen.Variant?sin fijarVariante de la tarjeta base.
Classstring""Clases CSS extra.
Stylestring""Estilo en línea adicional.

HighlightColorType.Auto mira los dígitos del Value: verde si hay alguno distinto de cero, rojo si además hay un signo menos y gris sin dígitos. Con formatos poco habituales, fija el color.

DnzKpiInline

Tira de números para cabeceras de ficha o pies de tarjeta. Los elementos van en una lista, no como marcado hijo.

<DnzKpiInline Items=@KpiItems Separator="DnzKpiInline.SeparatorType.Pipe" />

@code {
    List<DnzKpiInline.ItemModel> KpiItems = new()
    {
        new("Horas oficiales", "40h 00m", Icon: "calendar_month"),
        new("Realizado", "38h 30m", Icon: "work", ValueColor: "#d97706"),
    };
}

ItemModel lleva Label, Value y, opcionales, Icon, ValueColor, IconColor (vacío hereda ValueColor) y Tooltip. Separator admite None, MiddleDot (por defecto), Pipe y Slash. También acepta Class, Style y TestId (el data-testid).

DnzStatItem

Icono, valor grande y etiqueta debajo. El valor es contenido libre: cabe un DnzSpanMoney u otro componente.

<DnzStatItem Label="Facturado" Icon="payments"><DnzSpanMoney Amount=@totalFacturado /></DnzStatItem>
ParámetroTipoPor defectoQué hace
ChildContentRenderFragmentEl valor.
Labelstring""Etiqueta bajo el valor.
Iconstring""Icono Material, o imagen si empieza por / o http.
IconColorstring"var(--rz-primary)"Color del icono.
IconSizestring"40px"Tamaño del icono.
ValueColorstring""Color del valor.
ValueSizestring"fs-3"Clase Bootstrap de tamaño del valor.
VisiblebooltrueCon false no se muestra.
Classstring""Clases del contenedor.

DnzStatsDisplay

Una celda por métrica (valor grande, unidad pequeña y etiqueta), repartidas en horizontal. Statistics es obligatorio; Variant sin fijar lo decide la profundidad de DnzCard.

<DnzStatsDisplay Statistics=@stats Variant="Variant.Text" />

@code {
    private List<DnzStatsDisplay.StatisticModel> stats = new()
    {
        new() { Value = "12", Label = "Usuarios" },
        new() { Value = "45,3", Label = "Base de datos", Unit = "GB" },
    };
}

DnzDynamicStat

Recibe un DnzDynamicStatData y elige cómo mostrarlo. Con Render="Auto", las series de un solo valor salen como KPI y las series con categorías, como gráfica hasta 20 categorías y como tabla por encima. Con AllowViewSwitch=true, el usuario alterna entre columnas, líneas, anillo, barras apiladas, radar, polar y tabla.

<DnzDynamicStat Data=@_dataEvolucion ChartType="DnzDynamicStatChartTypeE.Line" AllowViewSwitch=true ChartHeight="280" />

@code {
    private DnzDynamicStatData _dataEvolucion = new()
    {
        IsLoaded = true,
        Series = new()
        {
            new DnzDynamicStatSeries
            {
                Label = "Ingresos", Color = "#16a34a", Format = DnzDynamicStatFormatE.Money,
                Items = new() { new("Ene", 48250), new("Feb", 51900) }
            },
            new DnzDynamicStatSeries
            {
                Label = "Gastos", Color = "#dc2626", Format = DnzDynamicStatFormatE.Money,
                Items = new() { new("Ene", 31200), new("Feb", 29800) }
            }
        }
    };
}

Una serie con SingleValue en lugar de Items se muestra como tarjeta KPI: new DnzDynamicStatSeries { Label = "Ventas", SingleValue = 48250, Format = DnzDynamicStatFormatE.Money }.

Muestra un DnzSkeleton mientras IsLoading es true o Data.IsLoaded es false, y el error si Data.ErrorMessage tiene texto. Para rellenarlo, usa IAQuery: una consulta por corte, no por tarjeta.

ParámetroTipoPor defectoQué hace
DataDnzDynamicStatDataObligatorio. Series, filas y estado de carga.
IsLoadingboolfalseFuerza el esqueleto.
Titlestring""Título del KPI o la gráfica.
Iconstring""Icono Material.
Colorstring""Color del texto en modo KPI.
RenderDnzDynamicStatRenderEAutoAuto, Kpi, Chart o Table.
ChartTypeDnzDynamicStatChartTypeEColumnColumn, Bar, Line, Donut, Spider, PolarArea, StackedBar.
HighlightColorDnzKpiCard.HighlightColorTypeUndefinedDegradado en modo KPI.
IsCompactboolfalseKPI de una línea.
VariantRadzen.Variant?sin fijarVariante de la tarjeta en modo KPI.
Descriptionstring""Texto bajo la cifra en modo KPI.
ChartHeightint300Alto de la gráfica en px.
ShowLegendbooltrueLeyenda.
ShowDataLabelsboolfalseValores sobre la gráfica.
PageSizeint10Filas por página en modo tabla.
AllowViewSwitchboolfalseBarra para cambiar de vista. Solo con datos agrupados.
OnClickEventCallbackAl pulsar el KPI.
Classstring""Clases CSS extra.
Stylestring""Estilo en línea adicional.

Los tipos están en DinaZen.Components.DnzDynamicStat:

ClaseCamposPara qué
DnzDynamicStatDataSeries, Columns, RawRows, ColumnLabels, Total, TimeMs, IsLoaded, ErrorMessageEl paquete completo. IsSingleValue, IsMultiKpi, HasGroupedData y MaxItemCount se calculan y guían Render="Auto".
DnzDynamicStatSeriesLabel, Color, Format, SingleValue, ItemsUna serie: un SingleValue (KPI) o una lista de Items (gráfica). GroupedTotal suma los Items.
DnzDynamicStatDataItemCategory, ValueUn punto: new(category, value).
DnzStatParameterField, Aggregation, Label, Color, FormatUn dato a agregar (Sum, Count, Avg, Min, Max, None), para construir el DnzDynamicStatData desde una consulta.

DnzDynamicStatFormatE: Auto, Money, Decimal, Integer, Percent y Raw.

DnzTimeComparisonDisplay

La comparación de 8h 30m frente a 8h en rojo con su barra, la versión compacta de Montaje en verde y la barra de ritmo de un objetivo trimestral retrasado
1: DnzTimeComparisonDisplay con 480 minutos previstos y 510 reales. 2: el de Montaje, con Compact. 3: DnzProgressRhythm con 62 de real y 70 de esperado.

Compara tiempo planificado con tiempo real, en minutos: verde hasta el 80 %, amarillo hasta el 100 % y rojo al pasarse. PlannedTime="480" ActualTime="510" muestra 8h 30m / 8h, +30m en rojo y la barra.

<DnzTimeComparisonDisplay PlannedTime="120" ActualTime="90" Label="Montaje" Compact=true />
ParámetroTipoPor defectoQué hace
PlannedTimedecimal0Minutos planificados. Con 0, solo muestra el tiempo real.
ActualTimedecimal0Minutos reales. Con los dos a 0, no muestra nada.
ShowProgressBarbooltrueBarra de progreso (con tiempo planificado).
ShowDiffbooltrueEtiqueta con la diferencia (+30m, -1h 10m).
CompactboolfalseUna sola línea, para tablas y pies de tarjeta.
Labelstring""Etiqueta encima; también va al texto emergente.

DnzProgressRhythm

Barra con el progreso real (CurrentProgress) y una marca con el esperado (ExpectedProgress), los dos en porcentaje. Indica si vas adelantado, en ritmo o retrasado. Los textos por defecto están en inglés: cámbialos por parámetro.

<DnzProgressRhythm CurrentProgress="62" ExpectedProgress="70" Title="Objetivo trimestral" ExpectedLabel="esperado" GoalAchievedText="Objetivo cumplido" OnTrackText="En ritmo" AheadText="Adelantado" BehindText="Retrasado" />
ParámetroTipoPor defectoQué hace
CurrentProgressdecimal0Progreso real. Por encima de 100, cumplido.
ExpectedProgressdecimal0Progreso esperado hoy. Con 0 no hay marca ni comparativa.
Titlestring"Progress"Título.
ExpectedLabelstring"expected"Etiqueta del esperado.
GoalAchievedTextstring"Goal achieved!"Texto al llegar al 100 %.
OnTrackTextstring"On track"Texto si real y esperado coinciden.
AheadTextstring"Ahead by"Prefijo si vas por delante.
BehindTextstring"Behind by"Prefijo si vas por detrás.

DnzSummaryBar

Dentro de un DnzReportProvider, suma las columnas de dinero y la de minutos, cuenta los true de las booleanas y muestra el rango de la fecha principal. Sin filas, no aparece.

<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
    <DnzSummaryBar />
</DnzReportProvider>

En esta página