Etiquetas y estados
Etiquetas de estado con color deducido del texto, etiquetas de producto, banderas, variaciones con flecha y puntos de estado en vivo.
Componentes para señalar un estado, una variación o una etiqueta de producto con su color.
| Necesitas | Componente |
|---|---|
| Una etiqueta de estado que toma el color del texto | DnzBadgetAutoColor |
| Marcar una función como PRO, Beta, Nuevo, IA o Premium | DnzSpecialBadges |
| Una bandera de país junto a su código ISO | DnzCountryBadge |
| Una variación con flecha y color | DnzDeltaBadge |
| Un punto de estado que late (en línea, alerta, caído) | DnzPulseDotAnimation |
| Cuántas filas hay en cada estado de un informe | DnzStatusSummary |
| Un aviso a ancho completo | DnzBanner, en Tarjetas y maquetación |
DnzBadgetAutoColor
Muestra el texto de Value en una etiqueta y elige el color sin que mantengas un diccionario. Con Value vacío no muestra nada.
<DnzBadgetAutoColor Value="Pagada" />
<DnzBadgetAutoColor Value=@estado BadgetStyle=@coloresPorEstado />
<DnzBadgetAutoColor Value="Lo que sea" Color="EnumTextoEstiloE.Estilo11" />El color sale de la primera regla que aplique:
Colordistinto deIndefinido: ese estilo, sin mirar el texto.EnumTextoEstiloE(deDemoUp.MyDinaup) va deEstilo1aEstilo74, las clasese1ae74de DinaZen: ver Los estilos.BadgetStyle: unDictionary<string, int>de texto exacto a índice de estilo, para estados propios de tu dominio. Es el mismo diccionario que trae cada columna de estado de un informe (BadgetsStyle).- Por palabra: normaliza el texto (minúsculas, sin espacios sobrantes) y lo busca en sus categorías. Sin acierto exacto, prueba coincidencia parcial (
pago parcial). Sin ningún acierto, gris.
| Color | Categoría | Ejemplos de texto |
|---|---|---|
| Verde | Positivos o completados | pagado, cobrada, activo, conciliado, aprobado, enviado, paid, done, confirmed |
| Rojo | Negativos o error | cancelado, vencido, rechazado, impagado, bloqueado, error, expired, failed, overdue |
| Cian | Pendientes o en espera | pendiente, abierto, por cobrar, borrador, pending, open, draft |
| Azul | En curso | en proceso, procesando, en curso, in progress, processing |
| Amarillo | Advertencia | atención, advertencia, aviso, próximo a vencer, warning, delayed |
También clasifica temporalidad (hoy, today, ahora), tipo de operación (venta, ingreso, compra), periodicidad y prioridad (urgente, crítico, alta).
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Value | string | Texto que se muestra y del que sale el color. | |
Color | EnumTextoEstiloE | Indefinido | Estilo explícito (regla 1). |
BadgetStyle | Dictionary<string, int> | null | Texto exacto a índice de estilo (regla 2). |
Visible | bool | true | Con false no se muestra. |
Style | string | null | CSS en línea del <span>. |
Click | EventCallback | Al pulsar la etiqueta. Con delegado, muestra el cursor de mano. |
Los estilos
Cada estilo es una clase badge eN de dinazen.css, con su versión para el tema oscuro. Es el mismo número que guarda un campo de estilo de Flex, así que una etiqueta pintada a mano con <span class="badge e38"> sale igual que en un informe. Los que llevan icono o animación lo traen en la propia clase: no hace falta ningún HTML más.
| N.º | Grupo | Para qué |
|---|---|---|
| 1-10 | Tipos, solo borde | Pizarra, naranja, amarillo, lima, azul cielo, violeta, rosa, gris, cian y rojo. Para tipos: factura, operación, categoría. |
| 11-20 | Estados, con relleno | Los mismos diez colores. Para estados: pendiente, pagado, cancelado. |
| 21-25 | Tipos, solo borde | Verde, marrón, negro, granate y morado. |
| 26-30 | Estados, con relleno | Verde y marrón en claro; negro, granate y morado en oscuro con letra blanca. |
| 31-50 | Estados con dibujo | Borrador (lápiz), abierto (candado abierto), nuevo (destello), en curso (loader), sincronizando (flechas que giran), en marcha (play), en directo (punto que late), esperando (reloj de arena), en pausa, programado (reloj), en revisión (ojo), bloqueado con rayas (42) o macizo (43), mantenimiento (llave inglesa), alarma (pulso rojo), urgente (se sacude), terminado con bandera de cuadros (47) o con sello (48), cancelado (prohibido) y archivado (caja). |
| 51-54 | Estado de servicio | Operativo, degradado, caído y sin datos, con un punto que dice si funciona. |
| 55-74 | Libres | Sin significado: oro, plata, bronce, amanecer, océano, aurora, neón, cristal, arcoíris, rotulador, tecla, ticket, sello, terminal, cómic, caramelo, lunares, cebra, cinta adhesiva y píxel. |
La regla de Dinaup: borde para los tipos y relleno para los estados. Se puede saltar, pero así una ficha distingue de un vistazo qué es una cosa y en qué punto está.
Los animados son para pocos registros: si en un listado se mueven cien filas, ninguna llama la atención. Si el sistema del usuario pide menos animaciones, se quedan quietos y conservan el icono.
DnzSpecialBadges
Etiqueta de producto con degradado, texto e icono fijados por Type: Pro (por defecto), Beta, New, IA o Premium. DnzCardTitle acepta el mismo enum en BadgeType.
<DnzSpecialBadges Type="DnzSpecialBadges.BadgeType.IA" />DnzCountryBadge
Bandera y código del país en una etiqueta. Si la bandera no carga, queda solo el código.
<DnzCountryBadge CountryCode="MX" Size=28 />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
CountryCode | string | "" | Obligatorio. ISO 3166-1 alpha-2 (ES, US, MX). Vacío no muestra nada. |
Size | int | 22 | Alto y ancho de la bandera en píxeles. |
FlagUrlTemplate | string | https://dinaupcdn.com/public/flags/{0}.svg | Plantilla de URL. {0} es el código en minúsculas. |
DnzDeltaBadge
Variación con color y flecha: verde con flecha ascendente si sube, rojo con flecha descendente si baja, gris con raya si es cero. Con null no muestra nada.
<DnzDeltaBadge Value=@variacionPct Tooltip="Frente al mes anterior" />
<DnzDeltaBadge Value=@bajasPct InvertColors=true />
<DnzDeltaBadge Value=@nuevosClientes IsPercent=false Size="DnzDeltaBadge.SizeType.Small" />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Value | decimal? | null | La variación. Su signo decide color, flecha y signo del texto. |
IsPercent | bool | true | true: formato 0.# con %. false: entero con separador de miles (N0). |
InvertColors | bool | false | Subir en rojo y bajar en verde, para gastos o bajas. |
Size | SizeType | Normal | Small o Normal. |
Tooltip | string | "" | Texto al pasar el ratón. |
DnzPulseDotAnimation
Punto de estado que late, para cuadros de mando en tiempo real. Si el sistema del usuario pide menos animaciones, deja de latir.
<DnzPulseDotAnimation Color="DnzPulseDotAnimation.PulseColor.Red" Pulse=false Size=18 Title="Servicio caído" />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Color | PulseColor | Obligatorio: Green, Yellow, Red, Gray. | |
Pulse | bool | true | Con false, el punto queda fijo. |
Size | int | 14 | Diámetro en píxeles. |
RingPadding | int | 6 | Espacio (px) entre el punto y el anillo. |
RingThickness | int | 2 | Grosor (px) del anillo. |
Title | string | null | Texto emergente y de accesibilidad. |
DnzStatusSummary
Agrupa las filas de un informe por su columna de estado y muestra cuántas hay en cada uno, con el color que el estado tiene en Dinaup y una barra de proporción. Va dentro de un DnzReportProvider y solo aparece si el informe trae filas y su columna de estado admite agrupación (Mapping.CanKanban).
<DnzReportProvider Client=@Client ReportId="7c1d4e90-2f5a-41b8-bc63-9e0a1b2c3d4f">
<DnzStatusSummary OnStatusClick=@FiltrarPorEstado />
</DnzReportProvider>OnStatusClick (EventCallback<string>) recibe el texto del estado pulsado, para filtrar el informe.