Skip to Content
Componentes

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.

Una fila por componente: etiquetas de DnzBadgetAutoColor coloreadas por palabra, las cinco de DnzSpecialBadges, cuatro variaciones de DnzDeltaBadge y los puntos de DnzPulseDotAnimation
NecesitasComponente
Una etiqueta de estado que toma el color del textoDnzBadgetAutoColor
Marcar una función como PRO, Beta, Nuevo, IA o PremiumDnzSpecialBadges
Una bandera de país junto a su código ISODnzCountryBadge
Una variación con flecha y colorDnzDeltaBadge
Un punto de estado que late (en línea, alerta, caído)DnzPulseDotAnimation
Cuántas filas hay en cada estado de un informeDnzStatusSummary
Un aviso a ancho completoDnzBanner, 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:

  1. Color distinto de Indefinido: ese estilo, sin mirar el texto. EnumTextoEstiloE (de DemoUp.MyDinaup) va de Estilo1 a Estilo74, las clases e1 a e74 de DinaZen: ver Los estilos.
  2. BadgetStyle: un Dictionary<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).
  3. 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.
ColorCategoríaEjemplos de texto
VerdePositivos o completadospagado, cobrada, activo, conciliado, aprobado, enviado, paid, done, confirmed
RojoNegativos o errorcancelado, vencido, rechazado, impagado, bloqueado, error, expired, failed, overdue
CianPendientes o en esperapendiente, abierto, por cobrar, borrador, pending, open, draft
AzulEn cursoen proceso, procesando, en curso, in progress, processing
AmarilloAdvertenciaatenció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ámetroTipoPor defectoQué hace
ValuestringTexto que se muestra y del que sale el color.
ColorEnumTextoEstiloEIndefinidoEstilo explícito (regla 1).
BadgetStyleDictionary<string, int>nullTexto exacto a índice de estilo (regla 2).
VisiblebooltrueCon false no se muestra.
StylestringnullCSS en línea del <span>.
ClickEventCallbackAl pulsar la etiqueta. Con delegado, muestra el cursor de mano.

Los estilos

Los 74 estilos de etiqueta, de e1 a e74, cada uno con su número y agrupados como en la tabla: tipos con borde, estados con relleno, estados con dibujo, estado de servicio y libres

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.ºGrupoPara qué
1-10Tipos, solo bordePizarra, naranja, amarillo, lima, azul cielo, violeta, rosa, gris, cian y rojo. Para tipos: factura, operación, categoría.
11-20Estados, con rellenoLos mismos diez colores. Para estados: pendiente, pagado, cancelado.
21-25Tipos, solo bordeVerde, marrón, negro, granate y morado.
26-30Estados, con rellenoVerde y marrón en claro; negro, granate y morado en oscuro con letra blanca.
31-50Estados con dibujoBorrador (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-54Estado de servicioOperativo, degradado, caído y sin datos, con un punto que dice si funciona.
55-74LibresSin 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ámetroTipoPor defectoQué hace
CountryCodestring""Obligatorio. ISO 3166-1 alpha-2 (ES, US, MX). Vacío no muestra nada.
Sizeint22Alto y ancho de la bandera en píxeles.
FlagUrlTemplatestringhttps://dinaupcdn.com/public/flags/{0}.svgPlantilla 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ámetroTipoPor defectoQué hace
Valuedecimal?nullLa variación. Su signo decide color, flecha y signo del texto.
IsPercentbooltruetrue: formato 0.# con %. false: entero con separador de miles (N0).
InvertColorsboolfalseSubir en rojo y bajar en verde, para gastos o bajas.
SizeSizeTypeNormalSmall o Normal.
Tooltipstring""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ámetroTipoPor defectoQué hace
ColorPulseColorObligatorio: Green, Yellow, Red, Gray.
PulsebooltrueCon false, el punto queda fijo.
Sizeint14Diámetro en píxeles.
RingPaddingint6Espacio (px) entre el punto y el anillo.
RingThicknessint2Grosor (px) del anillo.
TitlestringnullTexto 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.

En esta página