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.
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.
// useDialogService() renvoie l’API de dialogue du framework. Disponible sur n’importe quel
// fonction composante en dessous de <FluentDialogProvider> montée à l’application</FluentDialogProvider>
// Racine. L’objet retourné expose des méthodes asynchrones de montre* pour les confirmations,
// Infos / succès / avertissements / barres de messages d’erreur, et affichage personnalisé des dialogues.
import { useDialogService } from '@powerportalspro/react-fluent';
function MyComponent() {
const dialogs = useDialogService();
// ...
}using IDialogService = PowerPortalsPro.Web.Blazor.Services.IDialogService;
[Inject]
private IDialogService _dialogService { get; set; } = null!;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).
const result = await dialogs.showConfirmationAsync(
'Êtes-vous sûr de vouloir supprimer cet enregistrement ?',
{
title: 'Confirmer Supprimer',
primaryText: 'Oui',
secondaryText: 'Non',
},
);
if (!result.cancelled) {
// Utilisateur confirmé — procéder à la suppression
}var result = await _dialogService.ShowConfirmationAsync(
"Êtes-vous sûr de vouloir supprimer cet enregistrement ?",
title: "Confirmer Supprimer",
primaryText: "Oui",
secondaryText: "Non");
if (!result.Cancelled)
{
// Utilisateur confirmé — procéder à la suppression
}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.await dialogs.showInfoAsync('L’opération est terminée.', 'Informations');
await dialogs.showSuccessAsync('Disque sauvegardé avec succès.', 'Succès');
await dialogs.showWarningAsync('Cette action ne peut être annulée.', 'Avertissement');
await dialogs.showErrorAsync('Une erreur s’est produite lors de la sauvegarde.', 'Erreur');await _dialogService.ShowInfoAsync("L’opération est terminée.", "Informations");
await _dialogService.ShowSuccessAsync("Disque sauvegardé avec succès.", "Succès");
await _dialogService.ShowWarningAsync("Cette action ne peut être annulée.", "Avertissement");
await _dialogService.ShowErrorAsync("Une erreur s’est produite lors de la sauvegarde.", "Erreur");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.
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é.
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.
Nom | Paramètres | Type | Description |
|---|---|---|---|
ShowConfirmationAsync | string 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é à |
ShowErrorAsync | string 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. |
ShowInfoAsync | string message string title string primaryText | Task<DialogResult> | Affiche une conversation informative avec le contenu fourni message et attend que l’utilisateur la renverse. |
ShowSuccessAsync | string message string title string primaryText | Task<DialogResult> | Affiche un dialogue de réussite avec le fourni message et attend que l’utilisateur le rejette. |
ShowWarningAsync | string 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. |
ShowConfirmationAsyncmessage et deux boutons d’action, puis attend l’utilisateur doit en choisir un. Le retour Services.DialogResult est DialogResult.Cancelled fixé à ShowErrorAsyncmessage et attend que l’utilisateur la désactive.ShowInfoAsyncmessage et attend que l’utilisateur la renverse.ShowSuccessAsyncmessage et attend que l’utilisateur le rejette.ShowWarningAsyncmessage et attend que l’utilisateur la renverse.Nom | Type | Par défaut | Description |
|---|---|---|---|
Cancelled | bool | False | Obtient une valeur indiquant si le dialogue a été annulé (par exemple, l’utilisateur l’a rejeté sans confirmer). |
Data | Object? | Une charge utile de données optionnelle est renvoyée par la boîte de dialogue lorsqu’elle était fermée. |
CancelledDataNom | Paramètres | Type | Description |
|---|---|---|---|
Cancel | Object 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. |
CancelServices.DialogResult représentant un résultat annulé, transportant éventuellement une charge utile de données.Ok<T>Services.DialogResult représentant un résultat confirmé, portant result comme charge utile de données.