Deze gids legt uit hoe je JavaScript-evenementen (ook wel "hooks" genoemd) kunt in- of uitschakelen binnen de configuratie van een Formuliermodule.
WAARSCHUWING: Het JavaScript-gedeelte is bedoeld voor gebruikers met programmeerervaring. Het invoeren van niet-functionele of foutieve code kan de correcte werking van het formulier of de gehele site verstoren.
Stapsgewijze Procedure
Volg deze stappen om de JavaScript-evenementen die aan jouw Form zijn gekoppeld te beheren.
1. Toegang tot het JavaScript-gedeelte
1. Log in op het dashboard en open de Formulierbeheer module.
2. Selecteer het Formulier dat je wilt aanpassen.
3. Navigeer in het bewerkscherm van het Formulier naar het laatste horizontale tabblad getiteld Javascript.
2. Evenementen beheren
In de sectie Javascript vind je een lijst met beschikbare evenementen, elk weergegeven als een vakje (Action Box).
1. Zoek het JavaScript-evenement dat je wilt inschakelen of uitschakelen (bijvoorbeeld form.beforeSubmit, form.afterSuccess, enz.).
2. Let op de status van het vakje:
- Als het evenement Actief is, wordt het vakje gemarkeerd en zie je de knop Uitschakelen.
- Als het evenement Inactief is, is het vakje grijs en zie je de knop Inschakelen.
3. Om het evenement te inschakelen: klik op de knop Inschakelen (blauw). Het vakje wordt actief en je kunt de JavaScript-code invoeren in het tekstveld eronder.
4. Om het evenement te uitschakelen: klik op de knop Uitschakelen (rood). Eventuele aanwezige JavaScript-code blijft bewaard maar wordt niet uitgevoerd.
3. Code wijzigen (alleen als actief)
Als je een evenement hebt ingeschakeld:
1. Scroll naar beneden binnen het evenementvakje.
2. Je vindt een tekstveld (code-editor) omsloten door twee grijze code-regels:
javascript
$('form').on('naam_evenement', function($form, {data.variabele1, data.variabele2}) {
// HIER VOEG JE JE EIGEN JAVASCRIPT-CODE TOE
});
3. Voeg je aangepaste JavaScript-code toe of wijzig deze in het middelste gedeelte.
Opmerking over Evenementlogica:
- Indien toegestaan door het evenement (
canformat), kun je formuliergegevens wijzigen door een aangepastformdataarray terug te geven. - Indien toegestaan door het evenement (
can_stop), blokkeer je alle volgende evenementen door aan het einde van de functiereturn false;terug te geven.
4. Wijzigingen opslaan
Nadat je gewenste evenementen hebt in- of uitgeschakeld en benodigde code hebt toegevoegd:
1. Sla het volledige Formulier op (meestal door te klikken op de knop Opslaan of Volgende tot aan het einde van de wizard).
De wijzigingen in de JavaScript-evenementen worden effectief na opslag.
