Skip to Content
Componentes

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.

Una DnzCard con su DnzCardTitle y la ayuda abierta, dos DnzCardKV, una tarjeta anidada con velo, un DnzBanner verde y tres avatares de inicial
1: DnzCardTitle con Subtitle, una acción y HelpLink, con la ayuda abierta. 2: dos DnzCardKV. 3: una DnzCard anidada, en el nivel 1. 4: DnzBanner con Style Success. 5: DnzAvatarInitial.
<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>
NecesitasComponente
Una tarjeta que ajusta su relieve si va dentro de otraDnzCard
La cabecera con icono, título, acciones y ayudaDnzCardTitle
Que una rejilla llegue a ras de borde dentro de la tarjetaDnzCardBody
Una tarjeta pequeña con icono, etiqueta y valorDnzCardKV
Un bloque con botones de zoom que recuerda la escalaDnzScalableBlock
Un avatar circular con la inicial del nombreDnzAvatarInitial
Un aviso a ancho completo con icono, texto y botónDnzBanner
Mostrar un bloque solo si una comprobación de estado devuelve HealthyDnzHealthSection
El pie Powered by con el enlace a dinaup.comDnzFooterPoweredBy

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ámetroTipoPor defectoQué hace
VariantRadzen.Variant?sin fijarFuerza un aspecto. Sin valor: Filled en el nivel 0 y Flat en los anidados.
Stylestring""Estilos en línea, pasados a la RadzenCard.
ChildContentRenderFragmentContenido 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ámetroTipoPor defectoQué hace
Titlestring""Texto principal.
Subtitlestring""Segunda línea bajo el título. Vacío no se muestra.
Iconstring""Icono Material. Si es una ruta (/, http), se muestra como imagen.
BadgeTypeDnzSpecialBadges.BadgeType?Etiqueta especial junto al título (Pro, Beta, New, IA, Premium).
CompactboolfalseVersión reducida con borde inferior, para cabeceras secundarias.
HelpLinkstring""URL de documentación. Muestra el enlace Ver documentación, que abre una pestaña nueva.
HelpContentRenderFragmentContenido del panel de ayuda desplegable. Con HelpLink también, prevalece este.
ActionsRenderFragmentBotones 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ámetroTipoPor defectoQué hace
Titlestring""Etiqueta superior.
Valuestring""Valor principal.
Iconstring""Icono Material.
IconColorstringColors.PrimaryColor del icono.
VariantVariant?sin fijarFlat, Outlined.
Stylestring""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ámetroTipoPor defectoQué hace
Datastring""Texto del que sale la inicial y el color.
Sizestring"2.5rem"Diámetro ("32px").
OnClickEventCallbackAl pulsar el avatar.
Stylestring""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ámetroTipoPor defectoQué hace
StyleDnzBannerStylePrimaryTema, no CSS: Primary, Gold, Love, Danger, Success, Warning, Pro, Beta, New, Premium, IA. Para clases, AdditionalClass.
Titlestring""Título. Vacío no se muestra.
Iconstring""Icono Material Symbols.
ChildContentRenderFragmentCuerpo del aviso.
ButtonTextstring""Texto del botón. Solo aparece con DnzButtonrl.
DnzButtonrlstring""URL de destino del botón.
OpenInNewTabbooltrueAbre el enlace en pestaña nueva.
AdditionalClassstring""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.

ComponenteQué hace
DnzContainerColoca una tarjeta con coordenadas absolutas y muestra dentro una lista de informe, una lista primaria o botones, según su VirtualFormDTO.Container.
DnzControlEl campo de la ficha: elige el control (texto, número, fecha, casilla, selector, editor HTML) según el Format de su VirtualFormDTO.Control.
DnzControlSensibleUn campo confidencial (IsSensitive) o de contraseña: el valor aparece como puntos, con un botón para verlo y otro para copiarlo sin mostrarlo.

En esta página