Este guia explica como ativar ou desativar eventos JavaScript (também chamados de "hook") dentro da configuração de um módulo Form.
ATENÇÃO: A seção JavaScript é destinada a usuários com experiência em programação. Inserir código que não funcione ou incorreto pode comprometer o funcionamento correto do formulário ou de todo o site.
Procedimento Passo a Passo
Siga estes passos para gerenciar os eventos JavaScript associados ao seu Form.
1. Acessar a Seção JavaScript
1. Acesse o dashboard e abra o módulo de gerenciamento dos Forms.
2. Selecione o Form que deseja modificar.
3. Na tela de edição do Form, navegue até a última aba horizontal intitulada Javascript.
2. Gerenciar os Eventos
Na seção Javascript você encontrará uma lista de eventos disponíveis, cada um representado por um quadro (Action Box).
1. Localize o evento JavaScript que deseja ativar ou desativar (por exemplo, form.beforeSubmit, form.afterSuccess, etc.).
2. Observe o estado do quadro:
- Se o evento estiver Ativo, o quadro estará destacado e você verá o botão Desativar.
- Se o evento estiver Desativado, o quadro estará cinza e você verá o botão Ativar.
3. Para Ativar o evento: clique no botão Ativar (azul). O quadro será ativado e você poderá inserir o código JavaScript na área de texto abaixo.
4. Para Desativar o evento: clique no botão Desativar (vermelho). O código JavaScript eventualmente presente será mantido, mas não será executado.
3. Modificar o Código (Somente se Ativo)
Se você ativou um evento:
1. Role para baixo dentro do quadro do evento.
2. Você encontrará uma área de texto (editor de código) envolvida entre duas linhas de código cinza:
javascript
$('form').on('nome_evento', function($form, {data.variabile1, data.variabile2}) {
// AQUI VOCÊ INSERE SEU CÓDIGO JAVASCRIPT
});
3. Insira ou modifique seu código JavaScript personalizado na área central.
Nota sobre a Lógica dos Eventos:
- Se o evento permitir (
canformat), você pode modificar os dados do form retornando um arrayformdatamodificado. - Se o evento permitir (
can_stop), retornandoreturn false;ao final da função você bloqueará a execução de todos os eventos seguintes.
4. Salvar as Alterações
Após ativar ou desativar os eventos desejados e inserir o código necessário:
1. Prossiga salvando o Form completo (geralmente clicando no botão Salvar ou Avançar até o fim do assistente).
As alterações nos eventos JavaScript entrarão em vigor após a gravação.
