Ele IDialogService fornece métodos para exibir diálogos modais ao usuário, incluindo prompts de confirmação, mensagens de erro, avisos informativos, notificações de sucesso e avisos.
Acesse o serviço de diálogo a partir de qualquer componente. No React, chamada useDialogService() de dentro da árvore encapsulada pelo provedor de diálogo do framework; no Blazor, injetar o serviço via injeção de propriedades. Note que o serviço de diálogo PowerPortalsPro é distinto do serviço de diálogo subjacente FluentUI.
// useDialogService() retorna a API de diálogo do framework. Disponível em qualquer
// Componente de função abaixo <FluentDialogProvider> do montado no app</FluentDialogProvider>
// Root. O objeto retornado expõe métodos de show* assíncronos para confirmação,
// Informações / Sucesso / Aviso / Barras de Erro e Renderização de Diálogo Personalizada.
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!;Use ShowConfirmationAsync para pedir ao usuário uma pergunta de sim/não. A propriedade retornada DialogResult.Cancelled é true quando o usuário seleciona a opção secundária (negativa).
const result = await dialogs.showConfirmationAsync(
'Tem certeza de que quer apagar esse registro?',
{
title: 'Confirmar Excluir',
primaryText: 'Sim',
secondaryText: 'Não',
},
);
if (!result.cancelled) {
// Usuário confirmado — prossiga com a exclusão
}var result = await _dialogService.ShowConfirmationAsync(
"Tem certeza de que quer apagar esse registro?",
title: "Confirmar Excluir",
primaryText: "Sim",
secondaryText: "Não");
if (!result.Cancelled)
{
// Usuário confirmado — prossiga com a exclusão
}Use os seguintes métodos para mostrar diálogos de mensagens de um único botão com diferentes estilos visuais:
ShowInfoAsync — Mensagem informativa com ícone neutro.ShowSuccessAsync — Mensagem de sucesso com um ícone verde.ShowWarningAsync — Mensagem de aviso com um ícone amarelo.ShowErrorAsync — Mensagem de erro com um ícone vermelho de erro.await dialogs.showInfoAsync('A operação foi concluída.', 'Informações');
await dialogs.showSuccessAsync('Registro salvo com sucesso.', 'Sucesso');
await dialogs.showWarningAsync('Essa ação não pode ser desfeita.', 'Aviso');
await dialogs.showErrorAsync('Um erro ocorreu durante o salvamento.', 'Erro');await _dialogService.ShowInfoAsync("A operação foi concluída.", "Informações");
await _dialogService.ShowSuccessAsync("Registro salvo com sucesso.", "Sucesso");
await _dialogService.ShowWarningAsync("Essa ação não pode ser desfeita.", "Aviso");
await _dialogService.ShowErrorAsync("Um erro ocorreu durante o salvamento.", "Erro");Todos os métodos de diálogo aceitam opcionais title e primaryText parâmetros. Se omitidos, valores padrão localizados são usados. O diálogo de confirmação também aceita um secondaryText parâmetro para o rótulo do botão de cancelar.
Todos os métodos retornam um DialogResult objeto. Para diálogos de confirmação, verifique a Cancelled propriedade para determinar a escolha do usuário. Para diálogos de mensagens, o resultado indica que o diálogo foi descartado.
Use os controles abaixo para personalizar o título e a mensagem do diálogo, depois clique em qualquer botão para ver o tipo de diálogo correspondente.
Nome | Parâmetros | Tipo | Descrição |
|---|---|---|---|
ShowConfirmationAsync | string message string title string primaryText string secondaryText | Task<DialogResult> | Mostra um diálogo de confirmação com os botões fornecidos message e dois de ação, depois espera por o usuário deve escolher um. O retorno Services.DialogResult foi DialogResult.Cancelled definido para |
ShowErrorAsync | string message string title string primaryText | Task<DialogResult> | Mostra uma caixa de diálogo de erro com o fornecido message e espera o usuário descartá-lo. |
ShowInfoAsync | string message string title string primaryText | Task<DialogResult> | Mostra um diálogo informativo com o fornecido message e espera que o usuário o descarte. |
ShowSuccessAsync | string message string title string primaryText | Task<DialogResult> | Mostra um diálogo de sucesso com o fornecido message e espera o usuário descartá-lo. |
ShowWarningAsync | string message string title string primaryText | Task<DialogResult> | Mostra uma caixa de aviso com o fornecido message e espera o usuário descartá-lo. |
ShowConfirmationAsyncmessage e dois de ação, depois espera por o usuário deve escolher um. O retorno Services.DialogResult foi DialogResult.Cancelled definido para ShowErrorAsyncmessage e espera o usuário descartá-lo.ShowInfoAsyncmessage e espera que o usuário o descarte.ShowSuccessAsyncmessage e espera o usuário descartá-lo.ShowWarningAsyncmessage e espera o usuário descartá-lo.Nome | Tipo | Padrão | Descrição |
|---|---|---|---|
Cancelled | bool | False | Recebe um valor indicando se o diálogo foi cancelado (por exemplo, o usuário o descartou sem confirmar). |
Data | Object? | Carga útil opcional de dados retornada pelo diálogo quando ele era fechado. |
CancelledDataNome | Parâmetros | Tipo | Descrição |
|---|---|---|---|
Cancel | Object data | DialogResult | Cria um Services.DialogResult que representa um resultado cancelado, opcionalmente carregando uma carga útil de dados. |
Ok<T> | T result | DialogResult | Cria um Services.DialogResult que representa um resultado confirmado, carregando result como carga útil de dados. |
CancelServices.DialogResult que representa um resultado cancelado, opcionalmente carregando uma carga útil de dados.Ok<T>Services.DialogResult que representa um resultado confirmado, carregando result como carga útil de dados.