Skip to Content
Componentes

Carga y rendimiento

Indicador de carga, esqueleto, contenido diferido y límite de error: qué pieza va en cada momento de la carga de una pantalla Blazor.

Elige por el momento de la carga, no por el aspecto.

Tres tarjetas cargando: las cuatro bolitas de DnzLoader, los rectángulos grises de DnzSkeleton y el icono con barra de DnzIALoader
1: DnzLoader. 2: DnzSkeleton, con una línea al 55 % y cinco filas. 3: DnzIALoader con Text.
NecesitasUsa
Indicar que una sección entera espera sus datosDnzLoader
Reservar el hueco con la forma del contenido que llegaDnzSkeleton
Montar más tarde un bloque pesado de renderizarDnzDeferredContent
Que un bloque que falla al renderizar no rompa la páginaDnzTryComponent
Esperar una operación de IA con un textoDnzIALoader
Responder a un botón pulsadoIsBusy=@variable en el propio botón

DnzLoader

Indicador centrado mientras OnInitializedAsync trae los datos. Horizontal=true usa una tira de puntos compacta para barras y cabeceras.

@if (Facturas.IsNull())
{
    <DnzLoader />
}
else
{
    <FacturasGridU Data=@Facturas />
}

DnzSkeleton

Rectángulos animados que imitan el contenido que va a llegar. Combina varios para imitar un encabezado más filas.

<DnzSkeleton Lines="1" Height="0.7rem" MaxWidth="55%" />
<DnzSkeleton Lines="5" Height="0.9rem" />
ParámetroTipoPor defectoQué hace
Linesint1Número de rectángulos.
Heightstring"1rem"Alto de cada uno. "80px" imita una tarjeta o un KPI.
Radiusstring"0.25rem"Radio de las esquinas.
MaxWidthstring"100%"Ancho máximo del bloque ("400px", "55%").

DnzDeferredContent

Muestra un esqueleto durante DelayMs y después monta el contenido. Con retardos crecientes, lo importante aparece primero y el resto llega escalonado.

<DnzDeferredContent DelayMs="0">
    <KpiSeccionU Data=@Kpis />
</DnzDeferredContent>

<DnzDeferredContent DelayMs="300">
    <VentasPorMesGraficoU Data=@Ventas />
</DnzDeferredContent>

<DnzDeferredContent DelayMs="600" Class="p-3">
    <ChildContent>
        <TopClientesTablaU Data=@TopClientes />
    </ChildContent>
    <LoadingContent>
        <DnzLoader />
    </LoadingContent>
</DnzDeferredContent>
ParámetroTipoPor defectoQué hace
DelayMsint500Milisegundos antes de montar el contenido. 0 lo monta sin espera.
ChildContentRenderFragmentEl contenido que se aplaza.
LoadingContentRenderFragmentnullIndicador propio mientras espera. Sin él, un DnzSkeleton.
Classstring""Clase del contenedor de carga.

DnzDeferredContent aplaza el renderizado, no la carga de datos. Si lo lento es la consulta, tráela en OnInitializedAsync y muestra DnzLoader o DnzSkeleton mientras tanto.

DnzTryComponent

Captura la excepción de renderizado de su ChildContent (obligatorio) y muestra ErrorContent en su lugar, o nada si no lo pasas. En ErrorContent, context es la Exception. Recover() por @ref reintenta el renderizado.

<DnzTryComponent @ref="boundary">
    <ChildContent>
        <WidgetTercerosU Config=@Config />
    </ChildContent>
    <ErrorContent>
        <span>El widget falló: @context.Message</span>
        <RadzenButton Text="Reintentar" Click=@(() => boundary.Recover()) />
    </ErrorContent>
</DnzTryComponent>

@code {
    private DnzTryComponent boundary;
}

DnzIALoader

Icono animado con Text debajo (por defecto, "Analizando con IA...").

<DnzIALoader Text="Analizando el documento" />

Para el cuerpo de un diálogo, DnzDialogLayout trae IsLoading y ErrorText: Diálogos y ventanas.

En esta página