Este documento foi traduzido por IA. Para informações precisas, consulte a versão em inglês.
Baseada na API de notificação do Ant Design, esta API global de notificação é usada para exibir painéis de notificação no canto superior direito da página. Comparada ao ctx.message, as notificações podem incluir um título e uma descrição, tornando-as adequadas para conteúdos que precisam ser exibidos por um período mais longo ou que exigem a atenção do usuário.
| Cenário | Descrição |
|---|---|
| JSBlock / Eventos de Ação | Notificações de conclusão de tarefa, resultados de operações em lote, conclusão de exportação, etc. |
| Fluxo de Trabalho (FlowEngine) | Alertas de nível de sistema após o término de processos assíncronos. |
| Conteúdo que requer exibição prolongada | Notificações completas com títulos, descrições e botões de ação. |
NotificationInstance é a interface de notificação do Ant Design, que fornece os seguintes métodos.
| Método | Descrição |
|---|---|
open(config) | Abre uma notificação com configuração personalizada |
success(config) | Exibe uma notificação do tipo sucesso |
info(config) | Exibe uma notificação do tipo informação |
warning(config) | Exibe uma notificação do tipo aviso |
error(config) | Exibe uma notificação do tipo erro |
destroy(key?) | Fecha a notificação com a chave (key) especificada; se nenhuma chave for fornecida, fecha todas as notificações |
Parâmetros de Configuração (Consistentes com o Ant Design notification):
| Parâmetro | Tipo | Descrição |
|---|---|---|
message | ReactNode | Título da notificação |
description | ReactNode | Descrição da notificação |
duration | number | Atraso para fechamento automático (segundos). O padrão é 4,5 segundos; defina como 0 para desativar o fechamento automático |
key | string | Identificador único da notificação, usado em destroy(key) para fechar uma notificação específica |
onClose | () => void | Função de retorno (callback) acionada quando a notificação é fechada |
placement | string | Posição: topLeft | topRight | bottomLeft | bottomRight |
| Característica | ctx.message | ctx.notification |
|---|---|---|
| Posição | Centro superior da página | Canto superior direito (configurável) |
| Estrutura | Dica leve de linha única | Inclui título + descrição |
| Objetivo | Feedback temporário, desaparece automaticamente | Notificação completa, pode ser exibida por um longo tempo |
| Cenários Típicos | Sucesso da operação, falha de validação, sucesso de cópia | Conclusão de tarefa, mensagens do sistema, conteúdo longo que requer atenção |