#ctx.message

API global de mensagens do Ant Design, usada para exibir alertas leves e temporários no centro superior da página. As mensagens fecham automaticamente após um certo tempo ou podem ser fechadas manualmente pelo usuário.

#Cenários de uso

#Definição de tipo

message: MessageInstance;

MessageInstance é a interface de mensagem do Ant Design, fornecendo os seguintes métodos.

#Métodos comuns

Parâmetros:

• content (string | ConfigOptions): Conteúdo da mensagem ou objeto de configuração
• duration (number, opcional): Atraso para fechamento automático (segundos), o padrão é 3 segundos; defina como 0 para não fechar automaticamente

ConfigOptions (quando content é um objeto):

interface ConfigOptions {
  content: React.ReactNode;  // Conteúdo da mensagem
  duration?: number;        // Atraso para fechamento automático (segundos)
  onClose?: () => void;    // Callback ao fechar
  icon?: React.ReactNode;  // Ícone personalizado
}

#Exemplos

#Uso básico

ctx.message.success('Operação bem-sucedida');
ctx.message.error('Falha na operação');
ctx.message.warning('Selecione os dados primeiro');
ctx.message.info('Processando...');

#Internacionalização com ctx.t

ctx.message.success(ctx.t('Copied'));
ctx.message.warning(ctx.t('Please select at least one row'));
ctx.message.success(ctx.t('Exported {{count}} records', { count: rows.length }));

#Loading e fechamento manual

const hide = ctx.message.loading(ctx.t('Saving...'));
// Executa operação assíncrona
await saveData();
hide();  // Fecha o loading manualmente
ctx.message.success(ctx.t('Saved'));

#Uso do open com configuração personalizada

ctx.message.open({
  type: 'success',
  content: 'Alerta de sucesso personalizado',
  duration: 5,
  onClose: () => console.log('message closed'),
});

#Fechar todas as mensagens

ctx.message.destroy();

#Diferença entre ctx.message e ctx.notification

#Relacionado

• ctx.notification - Notificações no canto superior direito, adequadas para durações maiores
• ctx.modal - Confirmação em modal, interação bloqueante
• ctx.t() - Internacionalização, comumente usada com message