Tarjetas y maquetación
Tarjetas anidables, cabeceras de sección, bloques de contenido y avisos a ancho completo que dan a una app la estructura visual de Play.
Una pantalla de Play es una DnzCard con una cabecera DnzCardTitle y, debajo, tu rejilla, formulario o lista. Envuelve la rejilla en DnzCardBody para que llegue a ras de borde.
<DnzCard>
<DnzCardTitle Icon="inventory_2" Title="Productos">
<Actions>
<RadzenButton Text="Agregar" Icon="add" ButtonStyle="ButtonStyle.Primary" Size="ButtonSize.Small" Click=@OnAdd />
<RadzenButton Icon="refresh" Click=@RefreshDataAsync IsBusy=@cargando Variant="Variant.Text" Size="ButtonSize.Small" />
</Actions>
</DnzCardTitle>
<DnzCardBody>
<RadzenDataGrid Data=@productos TItem="ProductoDTO" />
</DnzCardBody>
</DnzCard>| Necesitas | Componente |
|---|---|
| Una tarjeta que ajusta su relieve si va dentro de otra | DnzCard |
| La cabecera con icono, título, acciones y ayuda | DnzCardTitle |
| Que una rejilla llegue a ras de borde dentro de la tarjeta | DnzCardBody |
| Una tarjeta pequeña con icono, etiqueta y valor | DnzCardKV |
| Un bloque con botones de zoom que recuerda la escala | DnzScalableBlock |
| Un avatar circular con la inicial del nombre | DnzAvatarInitial |
| Un aviso a ancho completo con icono, texto y botón | DnzBanner |
Mostrar un bloque solo si una comprobación de estado devuelve Healthy | DnzHealthSection |
| El pie Powered by con el enlace a dinaup.com | DnzFooterPoweredBy |
DnzCard
Usa DnzCard en lugar de RadzenCard. Suelta se ve igual. Anidada, pasa su profundidad a las hijas y alterna el aspecto: nivel 0 elevado, niveles impares con un velo neutro sin borde, pares con el fondo de tarjeta y una línea fina.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Variant | Radzen.Variant? | sin fijar | Fuerza un aspecto. Sin valor: Filled en el nivel 0 y Flat en los anidados. |
Style | string | "" | Estilos en línea, pasados a la RadzenCard. |
ChildContent | RenderFragment | Contenido de la tarjeta. |
La profundidad llega sola de la tarjeta padre ([CascadingParameter] DnzCardDepth). Los demás atributos (class, title, data-*) van a la RadzenCard.
DnzCardTitle
<DnzCardTitle Icon="receipt_long" Title="Facturas emitidas" Subtitle="Ejercicio 2026" HelpLink="https://doc.dinaup.com/docs/cuenta/usuarios">
<Actions>
<RadzenButton Text="Nueva factura" Icon="add" ButtonStyle="ButtonStyle.Primary" Size="ButtonSize.Small" Click=@CrearFactura />
</Actions>
</DnzCardTitle>| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Title | string | "" | Texto principal. |
Subtitle | string | "" | Segunda línea bajo el título. Vacío no se muestra. |
Icon | string | "" | Icono Material. Si es una ruta (/, http), se muestra como imagen. |
BadgeType | DnzSpecialBadges.BadgeType? | Etiqueta especial junto al título (Pro, Beta, New, IA, Premium). | |
Compact | bool | false | Versión reducida con borde inferior, para cabeceras secundarias. |
HelpLink | string | "" | URL de documentación. Muestra el enlace Ver documentación, que abre una pestaña nueva. |
HelpContent | RenderFragment | Contenido del panel de ayuda desplegable. Con HelpLink también, prevalece este. | |
Actions | RenderFragment | Botones a la derecha. Los que lanzan algo asíncrono llevan IsBusy. |
El botón de ayuda (interrogación a la derecha) solo aparece con HelpContent o HelpLink. Los atributos extra van al elemento raíz (parámetro Attributes).
DnzCardBody
Escapa del relleno de la tarjeta padre con margen negativo. Parámetros: ChildContent, Class y Style (se suma al margen negativo).
DnzCardKV
Tarjeta con icono coloreado a la izquierda, etiqueta encima y valor grande debajo, para filas de métricas.
<div class="d-flex gap-2">
<DnzCardKV Icon="payments" IconColor=@Colors.Success Title="Facturado mes" Value=@($"{totalMes.RoundMoney(2)} €") Variant="Variant.Outlined" />
<DnzCardKV Icon="inventory" IconColor=@Colors.Warning Title="Stock bajo" Value=@productosBajoStock.STR() Variant="Variant.Outlined" />
</div>| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Title | string | "" | Etiqueta superior. |
Value | string | "" | Valor principal. |
Icon | string | "" | Icono Material. |
IconColor | string | Colors.Primary | Color del icono. |
Variant | Variant? | sin fijar | Flat, Outlined. |
Style | string | "" | Estilo en línea (flex:1 para repartir el ancho). |
DnzScalableBlock
Añade al contenido dos botones de zoom y guarda la escala en localStorage con su Key, que es obligatorio y único por bloque.
<DnzScalableBlock Key="grid-facturas-2026">
<RadzenDataGrid Data=@facturas TItem="FacturaDTO" />
</DnzScalableBlock>DnzAvatarInitial
Avatar circular con la inicial de Data y un color fijo para cada letra. Vacío muestra ?.
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Data | string | "" | Texto del que sale la inicial y el color. |
Size | string | "2.5rem" | Diámetro ("32px"). |
OnClick | EventCallback | Al pulsar el avatar. | |
Style | string | "" | Estilos en línea adicionales. |
DnzBanner
Aviso a ancho completo en la parte superior de una pantalla: versión, oferta, mantenimiento o error a página completa.
<DnzBanner Style="DnzBanner.DnzBannerStyle.Success" Icon="check_circle" Title="Operación completada" ButtonText="Ver detalles" DnzButtonrl="/facturas/123">
<p>La factura se ha emitido y enviado al cliente.</p>
</DnzBanner>| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Style | DnzBannerStyle | Primary | Tema, no CSS: Primary, Gold, Love, Danger, Success, Warning, Pro, Beta, New, Premium, IA. Para clases, AdditionalClass. |
Title | string | "" | Título. Vacío no se muestra. |
Icon | string | "" | Icono Material Symbols. |
ChildContent | RenderFragment | Cuerpo del aviso. | |
ButtonText | string | "" | Texto del botón. Solo aparece con DnzButtonrl. |
DnzButtonrl | string | "" | URL de destino del botón. |
OpenInNewTab | bool | true | Abre el enlace en pestaña nueva. |
AdditionalClass | string | "" | Clases CSS extra. |
DnzHealthSection
Muestra ChildContent solo si la comprobación de estado CheckName (sin distinguir mayúsculas) devuelve Healthy en HealthCheckService.CheckHealthAsync(). Si no, muestra (Servicio no disponible en este momento.)
<DnzHealthSection CheckName="redis">
<ColaDeTrabajosU />
</DnzHealthSection>DnzFooterPoweredBy
Style admite Compact o Modern (por defecto): <DnzFooterPoweredBy Style="DnzFooterPoweredBy.FooterStyleType.Compact" />.
Piezas del formulario de Flex
DnzFormView monta estas piezas por cada pestaña de la ficha; no las instancias tú. Detalle en DnzFormView.
| Componente | Qué hace |
|---|---|
DnzContainer | Coloca una tarjeta con coordenadas absolutas y muestra dentro una lista de informe, una lista primaria o botones, según su VirtualFormDTO.Container. |
DnzControl | El campo de la ficha: elige el control (texto, número, fecha, casilla, selector, editor HTML) según el Format de su VirtualFormDTO.Control. |
DnzControlSensible | Un campo confidencial (IsSensitive) o de contraseña: el valor aparece como puntos, con un botón para verlo y otro para copiarlo sin mostrarlo. |