sc_ajax_message("mensagem", "titulo", "configuracaoVisual", "parametrosRedirecionamento")

A macro sc_ajax_message() permite exibir mensagens personalizadas durante a execução de aplicações que utilizem eventos Ajax.

Por meio dessa macro, é possível apresentar alertas, confirmações ou notificações, utilizando janelas modais, notificações estilo toast e opções de redirecionamento automático.

Seu uso é exclusivo para eventos Ajax.

Parâmetros

Parâmetro Obrigatoriedade Descrição e exemplo
mensagem Obrigatório

Texto da mensagem que será exibido. Pode conter HTML.
Exemplo:

  • "Operação realizada com sucesso!"
  • "Erro ao salvar dados"
titulo Opcional (Aceita vazio)

Título da janela da mensagem. Se não informado, será exibido sem título.
Exemplo:

  • "Atenção"
  • "Informativo"
stringConfiguracao Opcional (Aceita vazio)

Define o comportamento e estilo da mensagem. Deve ser passado como string com múltiplas opções separadas por &.
Os detalhes deste parâmetro estão detalhados na Tabela2: String de Configuracao

Exemplo:

  • "toast=Y&timeout=3&type=success&toast_pos=top-end"
  • "modal=Y&button=Y&button_label=OK"
parametrosRedirecionamento Opcional (Aceita vazio)

Define os valores que serão enviados à aplicação indicada em redir, no formato campo1=valor1;campo2=valor2.

Exemplo:
"cliente_id=123;cliente_nome=JOÃO"

 

Mesmo não sendo obrigatórios, os parâmetros devem ser passados na ordem correta. Se um parâmetro intermediário for omitido, ele deve ser mantido com valor vazio.

 

Tabela2: String de Configuracao

Propriedade Descrição Valores Exemplos Restrições / Observações
modal Define se a mensagem será exibida dentro de um modal.

Y - Mensagem será aberta no Modal

N - Mensagem será exibida sem modal. Neste caso a propriedade pode ser omitida.
  • "modal=Y"
  • "modal=Y&width=50"

Apenas em aplicações com o SweetAlert desativado.
timeout Determina o tempo de exibição da mensagem em segundos. Esta propriedade funciona apenas em mensagens sem botão de confirmação.

Aceita apenas números
  • "timeout=5"
  • "toast=Y&timeout=5"
  • "button=N&timeout=5"

Não compatível com botão de confirmação

  • Em aplicações com o SweetAlert desativado requer button=N ou omitido.
  • Em aplicações com o SweetAlert ativado requer toast=Y ou omitido
button

Controla a exibição do botão de confirmação dentro da mensagem. O funcionamento é confirmar a ação e fechar a mensagem.

Y - Botão de confirmação será exibido. Neste caso a mensagem deixa de ser exibida ao acionar o botão.

N - A mensagem será exibida sem um botão de confirmação. Neste caso ela respeita o tempo definido no timeout. Omitir a propriedade causa o mesmo efeito.
  • "button=Y"
  • "button=Y&button_label=Confirmar"

Apenas em aplicações com o SweetAlert desativado.
button_label Define o texto exibido no botão

Texto exibido no botão.
  • "button=Y&button_label=Fechar"
  • "button=Y&button_label=OK"

Requer botão de confirmação

  • Apenas em aplicações com o SweetAlert desativado
  • Requer button=Y.
top

Determina o posicionamento vertical da mensagem adicionando a propriedade top no CSS.

Quando omitido a mensagem calcula automaticamente.

Aceita apenas números
  • "top=650"
  • "top=650&timeout=5"

Apenas em aplicações com o SweetAlert desativado e requer modal=N ou omitido.
left

Determina o posicionamento horizontal da mensagem adicionando a propriedade left no CSS.

Quando omitido a mensagem calcula automaticamente.

Aceita apenas números
  • "left=650"
  • "top=50&left=650&timeout=5"

Apenas em aplicações com o SweetAlert desativado e requer modal=N ou omitido.
width Configura a largura da caixa de mensagem em pixel

Aceita apenas números
  • "width=650"
  • "width=650&timeout=5"

Apenas em aplicações com o SweetAlert desativado
height Configura a altura da caixa de mensagem em pixel

Aceita apenas números
  • "height=350"
  • "modal=Y&height=350&width=650"

Apenas em aplicações com o SweetAlert desativado
redir

URL ou nome da aplicação para redirecionamento. Este atributo funciona apenas com a propriedade botão habilitada.

 String com o nome da aplicação ou link.
  • "redir=form_comparison"
  • "button=Y&redir=form_comparison"
  • "redir=https://scriptcase.com.br/&target=_blank"

Requer botão de confirmação:

  • Aplicação com SweetAlert desativado requer button=Y o que seja omitido.
  • Aplicação com SweetAlert ativado requer toast=N o que seja omitido.
redir_target Define como o link informado no parâmetro redir será exibido.

_blank - Abre em uma nova janela ou aba.

_self - Abre no mesmo quadro em que foi clicado (comportamento padrão).

_parent – Abre no quadro pai.

_top – Abre ocupando todo o corpo da janela (quebra todos os frames).
  • "redir=https://scriptcase.com.br/&target=_blank"
  • "redir=form_comparison&target=_parent""
 Somente se redir estiver definido.
show_close Exibe botão de fechar mensagem na barra de título. Esta propriedade quando ativa força a exibição da barra de titulo mesmo que o parâmetro titulo esteja vazio.

Y - Botão fechar é exibido

N - Botão fechar não é exibido.

 "show_close=Y" Apenas em aplicações com o SweetAlert desativado
body_icon Exibe ou oculta ícone da mensagem. Mesmo quando esta propriedade está ativa a exibição do ícone depende da configuração do Tema da aplicação.

Y - Ícone da mensagem será exibido.

N - Ícone da mensagem não será exibido.

 "body_icon=N" Apenas em aplicações com o SweetAlert desativado
toast Exibe mensagem como toast

Y - Exibe a mensagem utilizando o toast

N - Exibe a mensagem utilizando o SweetAlert

 "toast=Y" Apenas em aplicações com o SweetAlert ativado
toast_pos Define a posição do toast na tela
  • top
  • top-start
  • top-end
  • center
  • center-start
  • center-end
  • bottom
  • bottom-start
  • bottom-end

"toast_pos=center&toast=Y&timeout=5"

"toast_pos=top&toast=N&type=warning"

 Apenas em aplicações com o SweetAlert ativado e requer toast=Y ou omitido.
type Define o ícone que será exibido na mensagem
  • warning
  • error
  • success
  • info
  • question

"toast=Y&timeout=5&type=success"

"toast=N&type=warning"

 Apenas em aplicações com o SweetAlert ativado.

 

Exemplo

1. Mensagem sem SweetAlert em Modal

sc_ajax_message("Dados salvos com sucesso!", "Confirmação", "modal=Y&button=Y&button_label=OK&show_close=Y");

2. Mensagem sem SweetAlert

sc_ajax_message("Atenção! Preencha todos os campos.", "Aviso", "button=Y");

3. Mensagem como Toast

sc_ajax_message("Produto adicionado ao carrinho!", "", "toast=Y&type=success&toast_pos=top-end&timeout=3");

4. Mensagem com SweetAlert

sc_ajax_message("Erro ao processar a solicitação!", "Erro", "type=error&button=Y");

 

Para a exibição da mensagem utilizando o Toast é necessário que esta opção Usar SweetAlert esteja habilitada na interface da aplicação.