Skip to Content
Componentes

Datos tipados (Spans)

Componentes para mostrar dinero, fechas, decimales, tiempo y tamaños con el formato y la región configurados en Dinaup.

Cada Span recibe un valor sin formato y lo muestra con el formato de la región de la empresa (el ICultureService que registra AddDinaZen). Hay uno por tipo de columna de un informe: el tipo del dato decide el componente.

<DnzSpanMoney Amount=@fila.Total AutoColor=true />
<DnzSpanDate Value=@fila.Fecha ShowStatus=true />
<DnzSpanMinutes Value=@fila.DuracionMinutos />

Con null, ninguno muestra nada: no hace falta envolverlos en un @if. Casi todos aceptan Class y FontSize ("16px"; "0.875rem" en las fechas).

Qué formatea cada uno

Importes en verde y rojo, un porcentaje, una fecha con la etiqueta Hoy, una duración y un tamaño; al lado, un importe con etiqueta e icono y un bloque de DnzSpanKV
1: varios Span, cada uno con su nombre. 2: DnzSpanMoney con Label e Icon. 3: DnzSpanKV, uno vertical y dos con Horizontal.
ComponenteValorQué muestraParámetros propios
DnzSpanMoneyAmount: decimal?Importe con el símbolo de moneda de la región.Ver DnzSpanMoney.
DnzSpanDecimaldecimal?Número con un sufijo libre.Symbol ( kg, uds), AutoColor.
DnzSpanPercentdecimal?, de 0 a 100Porcentaje con %: para "12,5 %" pasa 12.5, no 0.125.Decimals (1; los ceros de cola se omiten), AutoColor.
DnzSpanIntegerdecimal?Entero: trunca los decimales.Solo FontSize.
DnzSpanDateDateOnly?Fecha legible; el texto emergente lleva la fecha exacta.FriendlyMode (true), ShowBadge, ShowStatus (etiqueta Hoy, Ayer, Mañana, Pasado o Futuro).
DnzSpanDateTimeDateTime? en UTCFecha y hora en la hora de la empresa.Relative (hace 5 min, con el absoluto en el texto emergente), ShowBadge, ShowStatus (compara días en la zona de la empresa), Caption (texto pequeño).
DnzSpanMinutesdecimal? (minutos)Duración corta: 45m, 1h 30m, 3h, -30m.Solo FontSize.
DnzSpanByteslong?Tamaño en B, KB, MB, GB o TB.
DnzSpanGigaBytesdecimal? (GB)GB; desde 1024 pasa a TB y por debajo de 1 baja a MB o KB.AutoColor: semáforo de consumo, naranja por encima de 50 GB y rojo por encima de 100 GB.
DnzSpanGramsdecimal? (gramos)gr hasta 1000; por encima, Kg con dos decimales.AutoColor: color según si pasa de 1000 gr.
DnzTimeSpanDisplayTimeSpan?Duración en partes (2d 3h 15m), solo las distintas de cero.ShowSeconds, EmptyText (con null), NumberClass, LabelClass, Style.
DnzTimeSpanDisplayCompactTimeSpan?El mismo desglose en tamaño pequeño, para celdas.ShowSeconds, EmptyText, Style.
DnzTimeSpanDisplayBadgeTimeSpan?El mismo desglose, cada parte en una etiqueta.ShowSeconds, EmptyText, Style.
DnzSpanKVstringPar etiqueta y valor.Ver DnzSpanKV.
DnzFileNamestring + long?Fichero con icono, tamaño y descarga.Ver Entrada de datos y formularios.

AutoColor en DnzSpanMoney, DnzSpanDecimal y DnzSpanPercent pinta el valor en verde si es positivo y en rojo si es negativo. Úsalo en saldos, márgenes y variaciones, no en un total a pagar.

DnzSpanMoney

<DnzSpanMoney Amount=@resumen.PendienteCobro Label="Pendiente de cobro" Icon="payments" AutoColorRed=true FontSize="20px" />
ParámetroTipoPor defectoQué hace
Amountdecimal?0El importe. Con null no muestra nada.
Labelstring""Etiqueta encima del importe.
Iconstring""Icono Material a la izquierda. Requiere Label.
AutoColorboolfalseVerde si es positivo, rojo si es negativo.
AutoColorGreenboolfalseSolo verde cuando es positivo.
AutoColorRedboolfalseSolo rojo cuando es negativo.
CssClassstring""Clases extra del <span> (aquí no es Class).
FontSizestring"16px"Tamaño de fuente.
IsVisiblebooltrueOculta el componente sin quitarlo del árbol.

DnzSpanKV

Bloque de detalle de un diálogo o una ficha: la etiqueta y, debajo o al lado, el valor ya formateado o un ChildContent con marcado libre. Si pones ChildContent, se ignora Value.

<DnzSpanKV Key="Estado" Value=@item.Estado Icon="check_circle" />

<DnzSpanKV Key="Total" Horizontal=true Icon="euro" TextRight=true>
    <DnzSpanMoney Amount=@factura.Total />
</DnzSpanKV>
ParámetroTipoPor defectoQué hace
Keystring""La etiqueta.
ValuestringnullEl valor ya formateado.
ChildContentRenderFragmentnullMarcado libre para el valor. Tiene prioridad sobre Value.
HorizontalboolfalseEtiqueta y valor en la misma línea.
Iconstring""Icono Material, o URL de imagen si empieza por / o http.
IconColorstring""Color del icono.
ValueColorstring""Color del valor.
TextRightboolfalseAlinea el valor a la derecha.
LabelWidthstring""Ancho máximo de la etiqueta.
Classstring""Clases extra del contenedor.
VisiblebooltrueOculta el componente entero.

En esta página