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.
| Necesitas | Usa |
|---|---|
| Indicar que una sección entera espera sus datos | DnzLoader |
| Reservar el hueco con la forma del contenido que llega | DnzSkeleton |
| Montar más tarde un bloque pesado de renderizar | DnzDeferredContent |
| Que un bloque que falla al renderizar no rompa la página | DnzTryComponent |
| Esperar una operación de IA con un texto | DnzIALoader |
| Responder a un botón pulsado | IsBusy=@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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Lines | int | 1 | Número de rectángulos. |
Height | string | "1rem" | Alto de cada uno. "80px" imita una tarjeta o un KPI. |
Radius | string | "0.25rem" | Radio de las esquinas. |
MaxWidth | string | "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ámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
DelayMs | int | 500 | Milisegundos antes de montar el contenido. 0 lo monta sin espera. |
ChildContent | RenderFragment | El contenido que se aplaza. | |
LoadingContent | RenderFragment | null | Indicador propio mientras espera. Sin él, un DnzSkeleton. |
Class | string | "" | 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.