IDialogService

Il IDialogService fournit des méthodes pour afficher des dialogues modaux à l’utilisateur, y compris des invites de confirmation, des messages d’erreur, des notifications informatives, des notifications de réussite et des avertissements.

Injection du Service

Accédez au service de dialogue depuis n’importe quel composant. Dans React, appeler useDialogService() depuis l’intérieur de l’arbre enroulé par le fournisseur de dialogue du cadre ; dans Blazor, injecter le service via injection de propriétés. Notez que le service de dialogue PowerPortalsPro est distinct du service de dialogue sous-jacent FluentUI.

React
Blazor

Dialogues de confirmation

Utilisez-le ShowConfirmationAsync pour poser une question oui/non à l’utilisateur. La propriété retournée DialogResult.Cancelled est true lorsque l’utilisateur sélectionne l’option secondaire (négative).

React
Blazor

Dialogues de messages

Utilisez les méthodes suivantes pour afficher des dialogues de messages à un seul bouton avec différents styles visuels :

  • ShowInfoAsync — Message d’information avec une icône neutre.
  • ShowSuccessAsync — Message de réussite avec une icône verte à cocher.
  • ShowWarningAsync — Message d’avertissement avec une icône d’avertissement jaune.
  • ShowErrorAsync — Message d’erreur avec une icône d’erreur rouge.
React
Blazor

Paramètres communs

Toutes les méthodes de dialogue acceptent les options title et primaryText les paramètres. Si elles sont omises, des valeurs par défaut localisées sont utilisées. La boîte de dialogue de confirmation accepte également un secondaryText paramètre pour l’étiquette du bouton annuler.

Résultat du dialogue

Toutes les méthodes retournent un DialogResult objet. Pour les dialogues de confirmation, vérifiez la Cancelled propriété afin de déterminer le choix de l’utilisateur. Pour les dialogues de messages, le résultat indique que le dialogue a été rejeté.

Démo interactive

Utilisez les contrôles ci-dessous pour personnaliser le titre de dialogue et le message, puis cliquez sur n’importe quel bouton pour voir le type de dialogue correspondant.

Exemple de réaction
Exemple de Blazor
Dialogue de confirmation d’affichage Dialogue d’affichage des erreurs Dialogue Afficher Infos Dialogue de réussite de l’émission Dialogue d’avertissement affiché
React TypeScript
Razor
Réagir Blazor

IDialogService Interface

Méthodes

Nom
Paramètres
Type
Description
ShowConfirmationAsyncstring message
string title
string primaryText
string secondaryText
Task<DialogResult>
Affiche une boîte de confirmation avec les boutons fournis message et deux boutons d’action, puis attend l’utilisateur doit en choisir un. Le retour Services.DialogResult est DialogResult.Cancelled fixé à Vrai lorsque l’utilisateur sélectionne l’option secondaire (négative).
ShowErrorAsyncstring message
string title
string primaryText
Task<DialogResult>
Affiche une boîte d’erreur avec le fichier fourni message et attend que l’utilisateur la désactive.
ShowInfoAsyncstring message
string title
string primaryText
Task<DialogResult>
Affiche une conversation informative avec le contenu fourni message et attend que l’utilisateur la renverse.
ShowSuccessAsyncstring message
string title
string primaryText
Task<DialogResult>
Affiche un dialogue de réussite avec le fourni message et attend que l’utilisateur le rejette.
ShowWarningAsyncstring message
string title
string primaryText
Task<DialogResult>
Affiche une boîte d’avertissement avec le contenu fourni message et attend que l’utilisateur la renverse.
Nom: ShowConfirmationAsync
Paramètres: string message
string title
string primaryText
string secondaryText
Type: Task<DialogResult>
Description: Affiche une boîte de confirmation avec les boutons fournis message et deux boutons d’action, puis attend l’utilisateur doit en choisir un. Le retour Services.DialogResult est DialogResult.Cancelled fixé à Vrai lorsque l’utilisateur sélectionne l’option secondaire (négative).
Nom: ShowErrorAsync
Paramètres: string message
string title
string primaryText
Type: Task<DialogResult>
Description: Affiche une boîte d’erreur avec le fichier fourni message et attend que l’utilisateur la désactive.
Nom: ShowInfoAsync
Paramètres: string message
string title
string primaryText
Type: Task<DialogResult>
Description: Affiche une conversation informative avec le contenu fourni message et attend que l’utilisateur la renverse.
Nom: ShowSuccessAsync
Paramètres: string message
string title
string primaryText
Type: Task<DialogResult>
Description: Affiche un dialogue de réussite avec le fourni message et attend que l’utilisateur le rejette.
Nom: ShowWarningAsync
Paramètres: string message
string title
string primaryText
Type: Task<DialogResult>
Description: Affiche une boîte d’avertissement avec le contenu fourni message et attend que l’utilisateur la renverse.
Réagir Blazor

DialogResult Classe

Propriétés

Nom
Type
Par défaut
Description
Cancelledbool
False
Obtient une valeur indiquant si le dialogue a été annulé (par exemple, l’utilisateur l’a rejeté sans confirmer).
DataObject?
Une charge utile de données optionnelle est renvoyée par la boîte de dialogue lorsqu’elle était fermée.
Nom: Cancelled
Type: bool
Par défaut: False
Description: Obtient une valeur indiquant si le dialogue a été annulé (par exemple, l’utilisateur l’a rejeté sans confirmer).
Nom: Data
Type: Object?
Description: Une charge utile de données optionnelle est renvoyée par la boîte de dialogue lorsqu’elle était fermée.

Méthodes

Nom
Paramètres
Type
Description
CancelObject data
DialogResult
Crée un Services.DialogResult représentant un résultat annulé, transportant éventuellement une charge utile de données.
Ok<T>T result
DialogResult
Crée un Services.DialogResult représentant un résultat confirmé, portant result comme charge utile de données.
Nom: Cancel
Paramètres: Object data
Type: DialogResult
Description: Crée un Services.DialogResult représentant un résultat annulé, transportant éventuellement une charge utile de données.
Nom: Ok<T>
Paramètres: T result
Type: DialogResult
Description: Crée un Services.DialogResult représentant un résultat confirmé, portant result comme charge utile de données.