IDialogService

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, além de diálogos com conteúdo próprio.

Injeção do Serviço

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.

Diálogos de Confirmação

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

Diálogos de Mensagens

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.

Diálogos com seu próprio conteúdo

ShowDialogAsync mostra conteúdo seu, como um formulário, um seletor ou uma prévia, e retorna o que o diálogo encerra. No Blazor, passe um componente (ou um RenderFragment); no React, passe uma função que renderize o conteúdo. Defina PrimaryText e SecondaryText para os botões que o serviço desenha, ou deixe ambos de fora para conteúdo que desenha seu próprio.

O conteúdo recebe o diálogo em que é mostrado: um IDialogContext em Blazor, recebido como um parâmetro em cascata, e um DialogHandle em React, passado para a função de renderização e disponível em qualquer lugar dentro de . useDialogHandle()Use para fechar com um valor, cancelar, ativar ou desativar o botão primário, ou definir o que o botão primário faz. O que essa ação retorna é o que o diálogo retorna. Retorne KeepOpen (KEEP_OPEN no React) para manter o diálogo aberto, por exemplo, enquanto a entrada ainda não for válida.

Parâmetros Comuns

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.

Resultado do Diálogo

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.