Skip to Content
Componentes

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 /> en MainLayout.razor: instalación de DinaZen.
  • @inject DialogService DialogService en el componente que abre el diálogo.
NecesitasComponente
Tu propio diálogo con cabecera, cuerpo y pieDnzDialogLayout
Confirmar una acción antes de ejecutarlaDnzConfirmDialog
Que el usuario elija una fila de un informeDnzItemPickerDialog
El histórico de cambios de un campoDnzHistoricoDialog
Comentarios, ficheros o galería de un registroDnzAnnotationsDialog
Los registros que apuntan a esteDnzBacklinksDialog
Vista previa de un correo con botón de enviarDnzEmailPreviewDialog
Editar una imagen en un diálogoDnzImageEditorDialog, en Entrada de datos y formularios
Un informe, una ficha o un documento en ventana flotanteOpenAsWindow y DnzWindowManagerService

DnzDialogLayout

Rejilla de cabecera, cuerpo y pie. Solo el cuerpo se desplaza.

El diálogo Nueva retención del ejemplo: la cabecera con el título, el campo Nombre en el cuerpo y el pie con Cancelar y Guardar
<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ónEstiloVariante
CancelarDangerText
AceptarSuccesssólido, con IsBusy mientras procesa
ParámetroTipoPor defectoQué hace
TitlestringnullTítulo de la cabecera automática.
IconstringnullIcono Material de la cabecera automática.
TitleContentRenderFragmentnullCabecera a medida.
BodyContentRenderFragmentnullCuerpo. Es la única zona con desplazamiento.
FooterContentRenderFragmentnullPie con los botones.
ContentStylestringnullstyle del cuerpo.
HeaderStylestringnullstyle de la cabecera.
IsLoadingboolfalseSustituye el cuerpo por un esqueleto de carga.
LoadingTextstringnullCon texto, un indicador de carga con ese mensaje en lugar del esqueleto.
ErrorTextstringnullCon texto, sustituye el cuerpo por un aviso de error. Tiene prioridad sobre IsLoading.
OnRetryEventCallbackCon delegado, el aviso de error muestra Reintentar. Déjalo sin delegado en un error de configuración.
FlatboolfalseDiálogo blanco y plano, sin fondo gris ni degradados.
AltoAutoboolfalseSe 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.

La confirmación Eliminar dominio con severidad Danger: icono de aviso en rojo, el mensaje y los botones Cancelar y Eliminar
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:

ValorCuándo
InfoAviso sin riesgo.
WarningAcción que conviene revisar. Es el valor por defecto.
DangerAcción destructiva o irreversible (borrar, anular). El botón sale en rojo.
SuccessConfirmació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álogoQué haceCómo se abre
DnzHistoricoDialogHistó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.
DnzAnnotationsDialogComentarios, 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.
DnzBacklinksDialogLos 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)
DnzEmailPreviewDialogDnzEmailPreview 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")
DnzFormInspectorDialogInspector de los campos de una ficha, para depurar DnzFormView.Parámetros RowId, SectionId, SectionLabel, Fields: List<VirtualFormDTO.Control>.
DnzRecoveryPasswordWithDinaupDialogPanel 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

PropiedadTipoPor defectoQué hace
Titlestring""Título.
Subtitlestring""Subtítulo.
Iconstring""Icono Material.
IconUrlstring""URL de icono propio. Tiene prioridad sobre Icon.
InitialWidthdouble1100Ancho inicial en px.
InitialHeightdouble620Alto inicial en px.
MinWidthdouble1000Ancho mínimo. Redúcelo si el contenido es estrecho.
MinHeightdouble400Alto mínimo.
ControlKeystringnullIdentidad para "de esta solo puede haber una": volver a pedirla trae al frente la que ya hay y Open devuelve su id.
AmbitoAmbitoVentanaEPestanaAlcance de ese control: Pestana, Usuario o Licencia. Los dos últimos necesitan ResolverOcupadaFuera.
PresetIdstringnullId fijado de antemano, para pasar el WindowId al contenido antes de abrir.

DnzWindowManagerService

MiembroQué hace
WindowsLas ventanas abiertas (IReadOnlyList<WindowState>).
MaxWindows6 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, ToggleMinimizeCon el windowId.
UpdateTitle, UpdateSubtitle, UpdateIcon, UpdateWindowInfoCambian los rótulos de una ventana abierta.
GetWindow(windowId)El WindowState: id, título, posición, tamaño, IsMinimized, IsMaximized, IsActive, ControlKey.
OnChangedEvento al cambiar cualquier ventana.
ResolverOcupadaFueraFunc<string, AmbitoVentanaE, string> que la app rellena para los ámbitos Usuario y Licencia.
ControlKeysAbiertasLas ControlKey abiertas en este circuito, para publicarlas a otras sesiones.

En esta página