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
| Componente | Valor | Qué muestra | Parámetros propios |
|---|---|---|---|
DnzSpanMoney | Amount: decimal? | Importe con el símbolo de moneda de la región. | Ver DnzSpanMoney. |
DnzSpanDecimal | decimal? | Número con un sufijo libre. | Symbol ( kg, uds), AutoColor. |
DnzSpanPercent | decimal?, de 0 a 100 | Porcentaje con %: para "12,5 %" pasa 12.5, no 0.125. | Decimals (1; los ceros de cola se omiten), AutoColor. |
DnzSpanInteger | decimal? | Entero: trunca los decimales. | Solo FontSize. |
DnzSpanDate | DateOnly? | Fecha legible; el texto emergente lleva la fecha exacta. | FriendlyMode (true), ShowBadge, ShowStatus (etiqueta Hoy, Ayer, Mañana, Pasado o Futuro). |
DnzSpanDateTime | DateTime? en UTC | Fecha 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). |
DnzSpanMinutes | decimal? (minutos) | Duración corta: 45m, 1h 30m, 3h, -30m. | Solo FontSize. |
DnzSpanBytes | long? | Tamaño en B, KB, MB, GB o TB. | |
DnzSpanGigaBytes | decimal? (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. |
DnzSpanGrams | decimal? (gramos) | gr hasta 1000; por encima, Kg con dos decimales. | AutoColor: color según si pasa de 1000 gr. |
DnzTimeSpanDisplay | TimeSpan? | Duración en partes (2d 3h 15m), solo las distintas de cero. | ShowSeconds, EmptyText (con null), NumberClass, LabelClass, Style. |
DnzTimeSpanDisplayCompact | TimeSpan? | El mismo desglose en tamaño pequeño, para celdas. | ShowSeconds, EmptyText, Style. |
DnzTimeSpanDisplayBadge | TimeSpan? | El mismo desglose, cada parte en una etiqueta. | ShowSeconds, EmptyText, Style. |
DnzSpanKV | string | Par etiqueta y valor. | Ver DnzSpanKV. |
DnzFileName | string + 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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Amount | decimal? | 0 | El importe. Con null no muestra nada. |
Label | string | "" | Etiqueta encima del importe. |
Icon | string | "" | Icono Material a la izquierda. Requiere Label. |
AutoColor | bool | false | Verde si es positivo, rojo si es negativo. |
AutoColorGreen | bool | false | Solo verde cuando es positivo. |
AutoColorRed | bool | false | Solo rojo cuando es negativo. |
CssClass | string | "" | Clases extra del <span> (aquí no es Class). |
FontSize | string | "16px" | Tamaño de fuente. |
IsVisible | bool | true | Oculta 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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Key | string | "" | La etiqueta. |
Value | string | null | El valor ya formateado. |
ChildContent | RenderFragment | null | Marcado libre para el valor. Tiene prioridad sobre Value. |
Horizontal | bool | false | Etiqueta y valor en la misma línea. |
Icon | string | "" | Icono Material, o URL de imagen si empieza por / o http. |
IconColor | string | "" | Color del icono. |
ValueColor | string | "" | Color del valor. |
TextRight | bool | false | Alinea el valor a la derecha. |
LabelWidth | string | "" | Ancho máximo de la etiqueta. |
Class | string | "" | Clases extra del contenedor. |
Visible | bool | true | Oculta el componente entero. |