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 d’information, des notifications de réussite, des avertissements et des dialogues contenant votre propre contenu.

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.

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).

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.

Dialogues avec votre propre contenu

ShowDialogAsync affiche votre propre contenu, comme un formulaire, un sélecteur ou un aperçu, et renvoie ce avec quoi se termine la conversation. Dans Blazor, passez un composant (ou un RenderFragment) ; dans React, passez une fonction qui affiche le contenu. Définissez PrimaryText et SecondaryText pour les boutons que le service dessine, ou laissez les deux de côté pour le contenu qui dessine le sien.

Le contenu reçoit le dialogue dans lequel il est affiché : an IDialogContext in Blazor, reçu comme paramètre en cascade, et a DialogHandle dans React, passé à la fonction de rendu et disponible n’importe où à l’intérieur via useDialogHandle(). Utilisez-le pour fermer avec une valeur, annuler, activer ou désactiver le bouton principal, ou définir ce que fait le bouton principal. Ce que cette action retourne, c’est ce que le dialogue renvoie. Return KeepOpen (KEEP_OPEN dans React) pour garder la boîte de dialogue ouverte, par exemple tant que l’entrée n’est pas encore valide.

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é.