IDialogService

Proporciona IDialogService métodos para mostrar diálogos modales al usuario, incluyendo indicaciones de confirmación, mensajes de error, avisos informativos, notificaciones de éxito y advertencias, así como diálogos con contenido propio.

Inyectando el Servicio

Accede al servicio de diálogo desde cualquier componente. En React, la llamada useDialogService() desde dentro del árbol envuelta por el proveedor de diálogo del framework; en Blazor inyecta el servicio mediante inyección de propiedades. Ten en cuenta que el servicio de diálogo PowerPortalsPro es distinto del servicio de diálogo subyacente de FluentUI.

React Blazor

Diálogos de confirmación

Úsalo ShowConfirmationAsync para preguntar al usuario con un sí o no. La propiedad devuelta DialogResult.Cancelled es true cuando el usuario selecciona la opción secundaria (negativa).

React Blazor

Diálogos de mensajes

Utiliza los siguientes métodos para mostrar diálogos de mensajes de un solo botón con diferentes estilos visuales:

  • ShowInfoAsync — Mensaje informativo con un icono neutral.
  • ShowSuccessAsync — Mensaje de éxito con un icono verde de verificación de verificación.
  • ShowWarningAsync — Mensaje de advertencia con un icono amarillo de advertencia.
  • ShowErrorAsync — Mensaje de error con un icono de error rojo.
React Blazor

Diálogos con tu propio contenido

ShowDialogAsync muestra contenido propio, como un formulario, un selector o una vista previa, y devuelve lo que termina el diálogo. En Blazor, pasa un componente (o un RenderFragment); en React, pasa una función que muestre el contenido. Establece PrimaryText y SecondaryText para botones que el servicio dibuja, o deja ambos fuera para contenido que dibuja el suyo propio.

El contenido recibe el diálogo en el que se muestra: un IDialogContext en Blazor, recibido como parámetro en cascada, y un DialogHandle en React, pasado a la función de renderizado y disponible en cualquier parte dentro de . useDialogHandle()Úsalo para cerrar con un valor, cancelar, activar o desactivar el botón principal, o establecer qué hace el botón principal. Lo que esa acción devuelve es lo que devuelve el diálogo. Return KeepOpen (KEEP_OPEN en React) para mantener el diálogo abierto, por ejemplo, mientras la entrada aún no es válida.

React Blazor

Demo de contenido personalizado

Abre un diálogo con un formulario. Guardar mantiene el diálogo abierto hasta que se introduce un nombre, luego lo devuelve a la página; Cancelar no devuelve nada.

Ejemplo de reacción Ejemplo de Blazor React TypeScript Razor
Renombrar...

Parámetros comunes

Todos los métodos de diálogo aceptan parámetros opcionales title primaryText y de parámetros. Si se omiten, se utilizan valores predeterminados localizados. El diálogo de confirmación también acepta un secondaryText parámetro para la etiqueta del botón de cancelar.

Todos los métodos devuelven un DialogResult objeto. Para los diálogos de confirmación, comprueba la Cancelled propiedad para determinar la elección del usuario. En los diálogos de mensajes, el resultado indica que el diálogo fue descartado.

Demo interactiva

Utiliza los controles de abajo para personalizar el título y el mensaje del diálogo, luego haz clic en cualquier botón para ver el tipo de diálogo correspondiente.

Ejemplo de reacción Ejemplo de Blazor React TypeScript Razor
Cuadro de Diálogo de Confirmación de Mostrar Cuadro de diálogo de Mostrar Error Diálogo de Mostrar Información Diálogos de éxito en el programa Diálogo de advertencia de mostrar
Reaccionar Blazor

IDialogService Interface

Propiedades

Nombre
Tipo
Default
Descripción
OpenDialogCountint
¿Cuántos diálogos tiene actualmente abiertos este servicio? Solo sus propios diálogos — los cuadros de mensaje y las confirmaciones que aparecen a través de los métodos a continuación. Un panel de registros es un diálogo de FluentUI generado a través de su servicio, por lo que no lo es contado aquí, y eso es lo que hace que este número sea útil para la capa superpuesta: significa 'una mensaje que el usuario debe poder leer y responder', no 'algo con forma de diálogo abierto'.
Nombre: OpenDialogCount
Tipo: int
Descripción: ¿Cuántos diálogos tiene actualmente abiertos este servicio? Solo sus propios diálogos — los cuadros de mensaje y las confirmaciones que aparecen a través de los métodos a continuación. Un panel de registros es un diálogo de FluentUI generado a través de su servicio, por lo que no lo es contado aquí, y eso es lo que hace que este número sea útil para la capa superpuesta: significa 'una mensaje que el usuario debe poder leer y responder', no 'algo con forma de diálogo abierto'.

Métodos

Nombre
Parámetros
Tipo
Descripción
ShowConfirmationAsyncstring message
string title
string primaryText
string secondaryText
Task<DialogResult>
Muestra un diálogo de confirmación con los botones de acción y dos suministrados message , y luego espera a que el usuario debe elegir uno. El regreso Services.DialogResult se DialogResult.Cancelled ha establecido en Cierto cuando el usuario selecciona la opción secundaria (negativa).
ShowDialogAsync<TComponent>Action<CustomDialogOptions> configure
IDictionary<string, Object> parameters
Task<DialogResult>
Se muestra en un diálogo y espera a que se cierre.
ShowErrorAsyncstring message
string title
string primaryText
Task<DialogResult>
Muestra un diálogo de error con el código suministrado message y espera a que el usuario lo descarte.
ShowInfoAsyncstring message
string title
string primaryText
Task<DialogResult>
Muestra un diálogo informativo con el proporcionado message y espera a que el usuario lo descarte.
ShowSuccessAsyncstring message
string title
string primaryText
Task<DialogResult>
Muestra un diálogo de éxito con el proporcionado message y espera a que el usuario lo descarte.
ShowWarningAsyncstring message
string title
string primaryText
Task<DialogResult>
Muestra un diálogo de advertencia con el proporcionado message y espera a que el usuario lo descarte.
Nombre: ShowConfirmationAsync
Parámetros: string message
string title
string primaryText
string secondaryText
Tipo: Task<DialogResult>
Descripción: Muestra un diálogo de confirmación con los botones de acción y dos suministrados message , y luego espera a que el usuario debe elegir uno. El regreso Services.DialogResult se DialogResult.Cancelled ha establecido en Cierto cuando el usuario selecciona la opción secundaria (negativa).
Nombre: ShowDialogAsync<TComponent>
Parámetros: Action<CustomDialogOptions> configure
IDictionary<string, Object> parameters
Tipo: Task<DialogResult>
Descripción: Se muestra en un diálogo y espera a que se cierre.
Nombre: ShowErrorAsync
Parámetros: string message
string title
string primaryText
Tipo: Task<DialogResult>
Descripción: Muestra un diálogo de error con el código suministrado message y espera a que el usuario lo descarte.
Nombre: ShowInfoAsync
Parámetros: string message
string title
string primaryText
Tipo: Task<DialogResult>
Descripción: Muestra un diálogo informativo con el proporcionado message y espera a que el usuario lo descarte.
Nombre: ShowSuccessAsync
Parámetros: string message
string title
string primaryText
Tipo: Task<DialogResult>
Descripción: Muestra un diálogo de éxito con el proporcionado message y espera a que el usuario lo descarte.
Nombre: ShowWarningAsync
Parámetros: string message
string title
string primaryText
Tipo: Task<DialogResult>
Descripción: Muestra un diálogo de advertencia con el proporcionado message y espera a que el usuario lo descarte.
Reaccionar Blazor

DialogResult Clase

Propiedades

Nombre
Tipo
Default
Descripción
Cancelledbool
False
Obtiene un valor que indica si el diálogo fue cancelado (por ejemplo, el usuario lo descartó sin confirmarlo).
DataObject?
Carga útil de datos opcional devuelto por el diálogo cuando estaba cerrado.
Nombre: Cancelled
Tipo: bool
Default: False
Descripción: Obtiene un valor que indica si el diálogo fue cancelado (por ejemplo, el usuario lo descartó sin confirmarlo).
Nombre: Data
Tipo: Object?
Descripción: Carga útil de datos opcional devuelto por el diálogo cuando estaba cerrado.

Métodos

Nombre
Parámetros
Tipo
Descripción
CancelObject data
DialogResult
Crea un Services.DialogResult que representa un resultado cancelado, opcionalmente transportando una carga útil de datos.
GetData<T>T?
El valor con el que cerraba el diálogo, como : por defecto cuando era cancelado, cerrado con nada o cerrado con un valor de otro tipo.
Ok<T>T result
DialogResult
Crea un Services.DialogResult que representa un resultado confirmado, llevándose result como carga útil de datos.
TryGetData<T>out T value
bool
Lee el valor con el que se cerró el diálogo, como .
Nombre: Cancel
Parámetros: Object data
Tipo: DialogResult
Descripción: Crea un Services.DialogResult que representa un resultado cancelado, opcionalmente transportando una carga útil de datos.
Nombre: GetData<T>
Tipo: T?
Descripción: El valor con el que cerraba el diálogo, como : por defecto cuando era cancelado, cerrado con nada o cerrado con un valor de otro tipo.
Nombre: Ok<T>
Parámetros: T result
Tipo: DialogResult
Descripción: Crea un Services.DialogResult que representa un resultado confirmado, llevándose result como carga útil de datos.
Nombre: TryGetData<T>
Parámetros: out T value
Tipo: bool
Descripción: Lee el valor con el que se cerró el diálogo, como .
Reaccionar Blazor

CustomDialogOptions Clase

Propiedades

Nombre
Tipo
Default
Descripción
PreventDismissOnEscapebool
False
Si Escape no puede cerrar el diálogo. Por defecto false.
PrimaryTextstring?
La etiqueta del botón principal. El servicio dibuja el botón cuando esto está activado; deja ambos y CustomDialogOptions.SecondaryText no configurado para contenido que dibuja sus propios botones. ¿Qué botón es el botón hace es hasta IDialogContext.OnPrimary.
SecondaryTextstring?
La etiqueta del botón secundario. El servicio dibuja el botón cuando esto está activado y cancela El diálogo.
ShowDismissbool
True
Si el encabezado muestra un botón de cierre. Por defecto true.
Titlestring?
El título del diálogo, que aparece en el encabezado. Omitítelo en un diálogo sin uno.
Widthstring?
El ancho del diálogo como longitud CSS, por ejemplo, 'min(700px, 90vw)'. Omitítelo por defecto.
Nombre: PreventDismissOnEscape
Tipo: bool
Default: False
Descripción: Si Escape no puede cerrar el diálogo. Por defecto false.
Nombre: PrimaryText
Tipo: string?
Descripción: La etiqueta del botón principal. El servicio dibuja el botón cuando esto está activado; deja ambos y CustomDialogOptions.SecondaryText no configurado para contenido que dibuja sus propios botones. ¿Qué botón es el botón hace es hasta IDialogContext.OnPrimary.
Nombre: SecondaryText
Tipo: string?
Descripción: La etiqueta del botón secundario. El servicio dibuja el botón cuando esto está activado y cancela El diálogo.
Nombre: ShowDismiss
Tipo: bool
Default: True
Descripción: Si el encabezado muestra un botón de cierre. Por defecto true.
Nombre: Title
Tipo: string?
Descripción: El título del diálogo, que aparece en el encabezado. Omitítelo en un diálogo sin uno.
Nombre: Width
Tipo: string?
Descripción: El ancho del diálogo como longitud CSS, por ejemplo, 'min(700px, 90vw)'. Omitítelo por defecto.
Reaccionar Blazor

IDialogContext Interface

Propiedades

Nombre
Tipo
Default
Descripción
OnPrimaryFunc<Task<Object>>?
Se ejecuta cuando se pulsa el botón primario dibujado por servicio. Su resultado es lo que devuelve el diálogo, en DialogResult.Data; volver IDialogContext.KeepOpen para mantener abierto el diálogo en su lugar. Desactivado, el botón cierra el diálogo sin datos. Mientras se ejecuta, los botones son desactivado y Escape no cancela el diálogo (en el servidor Blazor, desde un momento después del Haz clic: el bloque llega al navegador una ida y vuelta después). Si se lanza, el error se registra, el diálogo permanece abierto y se muestra un mensaje de error general sobre él; para fallos que un usuario puede arreglar, decir tú mismo qué salió mal y devolverlo IDialogContext.KeepOpen.
PrimaryEnabledbool
Si el botón primario dibujado por servicio puede pulsarse, por ejemplo, solo una vez que se requiere una elección hecho. Por defecto true.
Nombre: OnPrimary
Tipo: Func<Task<Object>>?
Descripción: Se ejecuta cuando se pulsa el botón primario dibujado por servicio. Su resultado es lo que devuelve el diálogo, en DialogResult.Data; volver IDialogContext.KeepOpen para mantener abierto el diálogo en su lugar. Desactivado, el botón cierra el diálogo sin datos. Mientras se ejecuta, los botones son desactivado y Escape no cancela el diálogo (en el servidor Blazor, desde un momento después del Haz clic: el bloque llega al navegador una ida y vuelta después). Si se lanza, el error se registra, el diálogo permanece abierto y se muestra un mensaje de error general sobre él; para fallos que un usuario puede arreglar, decir tú mismo qué salió mal y devolverlo IDialogContext.KeepOpen.
Nombre: PrimaryEnabled
Tipo: bool
Descripción: Si el botón primario dibujado por servicio puede pulsarse, por ejemplo, solo una vez que se requiere una elección hecho. Por defecto true.

Métodos

Nombre
Parámetros
Tipo
Descripción
CancelAsyncTask
Cierra el diálogo como cancelado, lo que devuelve Cancel(System.Object).
CloseAsyncObject data
Task
Cierra el diálogo, que devuelve DialogResult.Ok`<T>(`<U>) con data.
Nombre: CancelAsync
Tipo: Task
Descripción: Cierra el diálogo como cancelado, lo que devuelve Cancel(System.Object).
Nombre: CloseAsync
Parámetros: Object data
Tipo: Task
Descripción: Cierra el diálogo, que devuelve DialogResult.Ok`<T>(`<U>) con data.