Ce guide explique comment activer ou désactiver les événements JavaScript (appelés aussi "hook") dans la configuration d'un module Form.
ATTENTION : La section JavaScript est destinée aux utilisateurs ayant une expérience en programmation. L'insertion de code non fonctionnel ou erroné peut compromettre le bon fonctionnement du formulaire ou du site entier.
Procédure Étape par Étape
Suivez ces étapes pour gérer les événements JavaScript associés à votre Formulaire.
1. Accéder à la Section JavaScript
1. Connectez-vous au tableau de bord et ouvrez le module de gestion des Forms.
2. Sélectionnez le Form que vous souhaitez modifier.
3. Dans l'écran de modification du Form, naviguez jusqu'à l'onglet horizontal final intitulé Javascript.
2. Gérer les Événements
Dans la section Javascript, vous trouverez une liste d'événements disponibles, chacun représenté par un cadre (Action Box).
1. Repérez l'événement JavaScript que vous souhaitez activer ou désactiver (par exemple, form.beforeSubmit, form.afterSuccess, etc.).
2. Observez l'état du cadre :
- Si l'événement est Actif, le cadre sera mis en évidence et vous verrez le bouton Désactiver.
- Si l'événement est Inactif, le cadre sera gris et vous verrez le bouton Activer.
3. Pour Activer l'événement : cliquez sur le bouton Activer (bleu). Le cadre s'activera et vous pourrez insérer le code JavaScript dans la zone de texte en dessous.
4. Pour Désactiver l'événement : cliquez sur le bouton Désactiver (rouge). Le code JavaScript éventuellement présent sera conservé, mais ne sera pas exécuté.
3. Modifier le Code (Seulement si Actif)
Si vous avez activé un événement :
1. Faites défiler vers le bas à l'intérieur du cadre de l'événement.
2. Vous trouverez une zone de texte (éditeur de code) encadrée par deux lignes de code grises :
javascript
$('form').on('nome_evento', function($form, {data.variabile1, data.variabile2}) {
// QUI INSERISSEZ VOTRE CODE JAVASCRIPT
});
3. Insérez ou modifiez votre code JavaScript personnalisé dans la zone centrale.
Note sur la Logique des Événements :
- Si l'événement le permet (
canformat), vous pouvez modifier les données du formulaire en retournant un tableauformdatamodifié. - Si l'événement le permet (
can_stop), retournerreturn false;à la fin de la fonction bloquera l'exécution de tous les événements suivants.
4. Sauvegarder les Modifications
Après avoir activé ou désactivé les événements souhaités et inséré le code nécessaire :
1. Procédez à la sauvegarde complète du Formulaire (généralement en cliquant sur le bouton Sauvegarder ou Suivant jusqu'à la fin de l'assistant).
Les modifications des événements JavaScript seront effectives après la sauvegarde.
