Attivare o disattivare gli eventi JavaScript (hook)

Questa guida spiega come attivare o disattivare gli eventi JavaScript (chiamati anche "hook") all'interno della configurazione di un modulo Form.

ATTENZIONE: La sezione JavaScript è destinata a utenti con esperienza di programmazione. L'inserimento di codice non funzionante o errato può compromettere il corretto funzionamento del form o dell'intero sito.

---

Procedura Passo-Passo

Segui questi passaggi per gestire gli eventi JavaScript associati al tuo Form.

1. Accedere alla Sezione JavaScript

1. Accedi alla dashboard e apri il modulo di gestione dei Form.

2. Seleziona il Form che desideri modificare.

3. Nella schermata di modifica del Form, naviga fino all'ultima scheda orizzontale intitolata Javascript.

2. Gestire gli Eventi

Nella sezione Javascript troverai un elenco di eventi disponibili, ciascuno rappresentato da un riquadro (Action Box).

1. Individua l'evento JavaScript che desideri attivare o disattivare (ad esempio, form.beforeSubmit, form.afterSuccess, ecc.).

2. Osserva lo stato del riquadro:

• Se l'evento è Attivo, il riquadro sarà evidenziato e vedrai il pulsante Disattiva.
• Se l'evento è Disattivo, il riquadro sarà in grigio e vedrai il pulsante Attiva.

3. Per Attivare l'evento: clicca sul pulsante Attiva (blu). Il riquadro si attiverà e potrai inserire il codice JavaScript nell'area di testo sottostante.

4. Per Disattivare l'evento: clicca sul pulsante Disattiva (rosso). Il codice JavaScript eventualmente presente verrà conservato, ma non verrà eseguito.

3. Modificare il Codice (Solo se Attivo)

Se hai attivato un evento:

1. Scorri verso il basso all'interno del riquadro dell'evento.

2. Troverai un'area di testo (editor di codice) racchiusa tra due righe di codice grigie:

javascript

$('form').on('nome_evento', function($form, {data.variabile1, data.variabile2}) {

// QUI INSERISCI IL TUO CODICE JAVASCRIPT

});

3. Inserisci o modifica il tuo codice JavaScript personalizzato nell'area centrale.

Nota sulla Logica degli Eventi:

• Se l'evento lo permette (canformat), puoi modificare i dati del form restituendo un array formdata modificato.
• Se l'evento lo permette (can_stop), ritornando return false; alla fine della funzione bloccherai l'esecuzione di tutti gli eventi successivi.

4. Salvare le Modifiche

Dopo aver attivato o disattivato gli eventi desiderati e aver inserito il codice necessario:

1. Procedi con il salvataggio del Form completo (di solito cliccando sul pulsante Salva o Avanti fino alla fine del wizard).

Le modifiche agli eventi JavaScript saranno effettive dopo il salvataggio.