Diálogos y ventanas
El esqueleto de diálogo de Dinaup, los diálogos predefinidos (confirmar, elegir ficha, histórico, anotaciones) y el gestor de ventanas flotantes.
Los diálogos se montan con DnzDialogLayout sobre el DialogService de Radzen. Los casos repetidos ya vienen hechos con un método estático OpenAsync. Para contenido que convive con la pantalla, abre una ventana flotante con DnzWindowManagerService.
Antes de empezar
<RadzenDialog />y<DnzWindowHost />enMainLayout.razor: instalación de DinaZen.@inject DialogService DialogServiceen el componente que abre el diálogo.
| Necesitas | Componente |
|---|---|
| Tu propio diálogo con cabecera, cuerpo y pie | DnzDialogLayout |
| Confirmar una acción antes de ejecutarla | DnzConfirmDialog |
| Que el usuario elija una fila de un informe | DnzItemPickerDialog |
| El histórico de cambios de un campo | DnzHistoricoDialog |
| Comentarios, ficheros o galería de un registro | DnzAnnotationsDialog |
| Los registros que apuntan a este | DnzBacklinksDialog |
| Vista previa de un correo con botón de enviar | DnzEmailPreviewDialog |
| Editar una imagen en un diálogo | DnzImageEditorDialog, en Entrada de datos y formularios |
| Un informe, una ficha o un documento en ventana flotante | OpenAsWindow y DnzWindowManagerService |
DnzDialogLayout
Rejilla de cabecera, cuerpo y pie. Solo el cuerpo se desplaza.
<DnzDialogLayout AltoAuto=true IsLoading=@cargando ErrorText=@errorCarga OnRetry=@CargarAsync>
<TitleContent>
<span>@(ID.IsEmpty() ? "Nueva retención" : "Editar retención")</span>
</TitleContent>
<BodyContent>
<div class="d-flex flex-column gap-3 p-3">
<RadzenFormField class="w-100" Text="Nombre" Variant="Variant.Flat">
<RadzenTextBox @bind-Value=@editandoNombre Style="width:100%" />
</RadzenFormField>
</div>
</BodyContent>
<FooterContent>
<div class="d-flex justify-content-end gap-2 align-items-center px-3">
<RadzenButton Click=@Cerrar ButtonStyle="ButtonStyle.Danger" Text="Cancelar" Variant="Variant.Text" />
<RadzenButton Click=@GuardarAsync ButtonStyle="ButtonStyle.Success" Text="Guardar" Icon="check" IsBusy=@isBusy />
</div>
</FooterContent>
</DnzDialogLayout>Sin TitleContent, la cabecera se genera con Title, Icon y el botón de cerrar. Sin FooterContent, el pie es un botón Cerrar. Si el guardado termina bien, cierra con DialogService.Close(true).
Convención del pie
| Botón | Estilo | Variante |
|---|---|---|
| Cancelar | Danger | Text |
| Aceptar | Success | sólido, con IsBusy mientras procesa |
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Title | string | null | Título de la cabecera automática. |
Icon | string | null | Icono Material de la cabecera automática. |
TitleContent | RenderFragment | null | Cabecera a medida. |
BodyContent | RenderFragment | null | Cuerpo. Es la única zona con desplazamiento. |
FooterContent | RenderFragment | null | Pie con los botones. |
ContentStyle | string | null | style del cuerpo. |
HeaderStyle | string | null | style de la cabecera. |
IsLoading | bool | false | Sustituye el cuerpo por un esqueleto de carga. |
LoadingText | string | null | Con texto, un indicador de carga con ese mensaje en lugar del esqueleto. |
ErrorText | string | null | Con texto, sustituye el cuerpo por un aviso de error. Tiene prioridad sobre IsLoading. |
OnRetry | EventCallback | Con delegado, el aviso de error muestra Reintentar. Déjalo sin delegado en un error de configuración. | |
Flat | bool | false | Diálogo blanco y plano, sin fondo gris ni degradados. |
AltoAuto | bool | false | Se ajusta al contenido hasta 85vh (variable CSS --dnz-dialog-alto-max), con el pie siempre visible. Ábrelo con Height = null en las DialogOptions. |
AltoAuto=true es la forma recomendada, salvo cuando el cuerpo se dimensiona con el hueco (un TPV a pantalla completa, un lienzo, un visor): ahí el alto lo ponen las DialogOptions. Por @ref tienes SetWidth(string), SetHeight(string) y Cerrar().
DnzConfirmDialog
Confirmación antes de una acción. Devuelve true si el usuario confirma y false si cancela o cierra.
if (await DnzConfirmDialog.OpenAsync(DialogService, $"Se elimina el dominio '{dominio}' y no se puede deshacer.", "Eliminar dominio", DnzConfirmSeverity.Danger, "Eliminar") == false) return;
await BorrarDominioAsync(dominio);public static async Task<bool> OpenAsync(DialogService dialogService, string message, string title = "Confirmar", DnzConfirmSeverity severity = DnzConfirmSeverity.Warning, string okText = "Confirmar", string cancelText = "Cancelar")message explica la consecuencia y okText lleva el verbo de la acción ("Eliminar", "Dar de baja"). severity cambia el icono, el color y el botón de aceptar:
| Valor | Cuándo |
|---|---|
Info | Aviso sin riesgo. |
Warning | Acción que conviene revisar. Es el valor por defecto. |
Danger | Acción destructiva o irreversible (borrar, anular). El botón sale en rojo. |
Success | Confirmación de algo que va a completarse. |
DnzItemPickerDialog
Abre un DnzReportView de 50 filas por página en un diálogo redimensionable y arrastrable (ancho min(95%, 1806px), alto 600 px) y devuelve la fila elegida, o null si el usuario cancela. Úsalo cuando elegir es una acción aparte (un botón Elegir cliente); para un campo del formulario, DnzRowSelector.
public static async Task<DinaupDynamicRowDTO> OpenAsync(DialogService dialogService, DinaupClientC client, string reportId)Otros diálogos
| Diálogo | Qué hace | Cómo se abre |
|---|---|---|
DnzHistoricoDialog | Histórico de cambios de un campo: el valor vigente con autor y fecha, y cada cambio como antes y después. Lee Client.GetHistoryChanges. | Open(DialogService dialogService, DinaupClientC client, Guid sectionId, Guid rowId, string field, string fieldLabel = null). Sin fieldLabel muestra el nombre interno del campo. |
DnzAnnotationsDialog | Comentarios, ficheros y galería pública de un registro, con un redactor con menciones. Lee con Client.Annotations_GetAsync y escribe con Client.Annotation_PutAsync. | OpenAsync(DialogService dialogService, DinaupClientC client, Guid sectionId, Guid rowId, AnnotationTypeE type), con type Comments, Files o PublicGallery. DnzFormView lo pide con OnAnnotationOpen. |
DnzBacklinksDialog | Los registros que apuntan al registro dado, una línea por campo de relación. Lee Client.GetBacklinksAsync. | OpenAsync(DialogService ds, DinaupClientC client, string sectionId, string rowId) |
DnzEmailPreviewDialog | DnzEmailPreview con un botón de confirmar. Devuelve true si se pulsa. | OpenAsync(DialogService dialogService, string body, string destinatario, string asunto, EventCallback onConfirmar, string confirmarTexto = "Enviar") |
DnzFormInspectorDialog | Inspector de los campos de una ficha, para depurar DnzFormView. | Parámetros RowId, SectionId, SectionLabel, Fields: List<VirtualFormDTO.Control>. |
DnzRecoveryPasswordWithDinaupDialog | Panel informativo de recuperación de contraseña con la cuenta Dinaup. | DialogService.OpenAsync<DnzRecoveryPasswordWithDinaupDialog>, sin parámetros. |
Ventanas flotantes
Panel arrastrable, redimensionable, minimizable y maximizable que convive con la pantalla. Las gestiona DnzWindowManagerService (uno por circuito) y las muestra DnzWindowHost, con la barra de tareas DnzTaskbar cuando hay alguna abierta.
DnzReportView, DnzFormView y DnzDynamicDocumentView traen OpenAsWindow, que devuelve el id de la ventana. Para tu propio contenido, Open(WindowOptions options, RenderFragment content):
@inject DnzWindowManagerService WindowManager
@code {
private void AbrirCliente(string clienteId)
{
DnzFormView.OpenAsWindow(WindowManager, Client, SectionsD.EntidadesD._SectionID, clienteId, title: "Cliente");
}
private void AbrirTarea(string tareaId, string titulo)
{
RenderFragment content = builder =>
{
builder.OpenComponent<TareaU>(0);
builder.AddAttribute(1, "TareaId", tareaId);
builder.CloseComponent();
};
WindowManager.Open(new WindowOptions { Title = titulo, Icon = "task_alt", MinWidth = 800 }, content);
}
}WindowOptions
| Propiedad | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Title | string | "" | Título. |
Subtitle | string | "" | Subtítulo. |
Icon | string | "" | Icono Material. |
IconUrl | string | "" | URL de icono propio. Tiene prioridad sobre Icon. |
InitialWidth | double | 1100 | Ancho inicial en px. |
InitialHeight | double | 620 | Alto inicial en px. |
MinWidth | double | 1000 | Ancho mínimo. Redúcelo si el contenido es estrecho. |
MinHeight | double | 400 | Alto mínimo. |
ControlKey | string | null | Identidad para "de esta solo puede haber una": volver a pedirla trae al frente la que ya hay y Open devuelve su id. |
Ambito | AmbitoVentanaE | Pestana | Alcance de ese control: Pestana, Usuario o Licencia. Los dos últimos necesitan ResolverOcupadaFuera. |
PresetId | string | null | Id fijado de antemano, para pasar el WindowId al contenido antes de abrir. |
DnzWindowManagerService
| Miembro | Qué hace |
|---|---|
Windows | Las ventanas abiertas (IReadOnlyList<WindowState>). |
MaxWindows | 6 ventanas a la vez. Al superarlo, Open no abre y dispara OnMaxWindowsReached. |
Open(options, content) | Abre y devuelve el id. Devuelve null si otra sesión tiene la ventana con ese ControlKey (OnVentanaOcupada). |
Close(windowId), CloseActive() | Cierra una ventana o la activa. |
Focus, Minimize, Restore, ToggleMaximize, ToggleMinimize | Con el windowId. |
UpdateTitle, UpdateSubtitle, UpdateIcon, UpdateWindowInfo | Cambian los rótulos de una ventana abierta. |
GetWindow(windowId) | El WindowState: id, título, posición, tamaño, IsMinimized, IsMaximized, IsActive, ControlKey. |
OnChanged | Evento al cambiar cualquier ventana. |
ResolverOcupadaFuera | Func<string, AmbitoVentanaE, string> que la app rellena para los ámbitos Usuario y Licencia. |
ControlKeysAbiertas | Las ControlKey abiertas en este circuito, para publicarlas a otras sesiones. |