logo
logo
Home / Gestisci gli eventi con il Widget

Gestire gli eventi del widget di verifica nei moduli

Il widget ti permette di aggiungere facilmente i servizi di verifica ai moduli web con cui raccogli dati. Con la procedura guidata decidi quali verifiche attivare, su quali campi e con quale comportamento. Per esempio, puoi impedire l’invio dei dati se un campo contiene un indirizzo email, un numero di telefono o un indirizzo postale errato, oppure evidenziare in rosso il campo errato e lasciare comunque inviare il modulo.

Oltre alle opzioni della procedura guidata, puoi gestire tutto via codice, così chi programma ha il pieno controllo su come il modulo reagisce agli eventi di verifica. Per farlo devi disattivare, al passaggio 4, l’opzione «Gestisci l’invio del modulo».

Hai 4 opzioni:

  • JavaScript standard con gestione asincrona
  • JavaScript standard senza gestione asincrona
  • jQuery con gestione asincrona
  • jQuery senza gestione asincrona
Gestionar eventos con el Widget

Convalida del modulo con JavaScript e gestione asincrona

				
					<!DOCTYPE html>
<html>
<head>
    
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    
    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/widgetjs/widgetjs.js?ver=1793278211" type="text/javascript"></script>
    <script>widgetJS.init('********TOKEN********');</script>
    
    <script>
        // Esempio con JavaScript standard
        document.addEventListener('DOMContentLoaded', function () {
            const form = document.getElementById('myform');

            form.addEventListener('submit', async function (event) {
                event.preventDefault(); // Impedisce l'invio del modulo

                // Convalida il modulo
                const isFormValid = await widgetJS.isFormValid('#myform');

                if (isFormValid) {
                    // Se il modulo è valido, invialo e/o esegui altre operazioni.
                    form.submit();
                } else {
                    // Se il modulo non è valido, mostra un messaggio di errore o esegui un'altra operazione. 
		    // Vengono applicati anche gli stili CSS definiti nel widget.
                    alert('Il modulo non è valido. Controlla i campi.');
                }

		// Qui puoi aggiungere altro codice
            });
        });
    </script>
<style id="wpr-lazyload-bg-container"></style><style id="wpr-lazyload-bg-exclusion"></style>
<noscript>
<style id="wpr-lazyload-bg-nostyle"></style>
</noscript>
<script type="application/javascript">const rocket_pairs = []; const rocket_excluded_pairs = [];</script></head>
<body>
    <form id="myform" class="profile-form">
        <label for="name">Nome:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Invia</button>
    </form>
<script>(()=>{class RocketElementorPreload{constructor(){this.deviceMode=document.createElement("span"),this.deviceMode.id="elementor-device-mode-wpr",this.deviceMode.setAttribute("class","elementor-screen-only"),document.body.appendChild(this.deviceMode)}t(){let t=getComputedStyle(this.deviceMode,":after").content.replace(/"/g,"");this.animationSettingKeys=this.i(t),document.querySelectorAll(".elementor-invisible[data-settings]").forEach(t=>{const e=t.getBoundingClientRect();if(e.bottom>=0&&e.top<=window.innerHeight)try{this.o(t)}catch(t){}})}o(t){const e=JSON.parse(t.dataset.settings),i=e.m||e.animation_delay||0,n=e[this.animationSettingKeys.find(t=>e[t])];if("none"===n)return void t.classList.remove("elementor-invisible");t.classList.remove(n),this.currentAnimation&&t.classList.remove(this.currentAnimation),this.currentAnimation=n;let o=setTimeout(()=>{t.classList.remove("elementor-invisible"),t.classList.add("animated",n),this.l(t,e)},i);window.addEventListener("rocket-startLoading",function(){clearTimeout(o)})}i(t="mobile"){const e=[""];switch(t){case"mobile":e.unshift("_mobile");case"tablet":e.unshift("_tablet");case"desktop":e.unshift("_desktop")}const i=[];return["animation","_animation"].forEach(t=>{e.forEach(e=>{i.push(t+e)})}),i}l(t,e){this.i().forEach(t=>delete e[t]),t.dataset.settings=JSON.stringify(e)}static run(){const t=new RocketElementorPreload;requestAnimationFrame(t.t.bind(t))}}document.addEventListener("DOMContentLoaded",RocketElementorPreload.run)})();</script></body>
</html>
				
			

Convalida del modulo con JavaScript senza gestione asincrona

				
					<!DOCTYPE html>
<html>
<head>
    
    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/jquery-3.6.0.min.js?ver=1793278211"></script>
    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/widgetjs/widgetjs.js?ver=1793278211" type="text/javascript"></script>
    <script>widgetJS.init('********TOKEN********');</script>
    <script>
        // Esempio con JavaScript standard
        document.addEventListener('DOMContentLoaded', function() {
            const form = document.getElementById('myform');

            form.addEventListener('submit', function(event) {
                event.preventDefault(); // Impedisce l'invio del modulo

                // Convalida il modulo
                widgetJS.isFormValid('#myform').then(isFormValid => {
                    if (isFormValid) {
                        // Se il modulo è valido, invialo
                        form.submit();
                    } else {
                        // Se il modulo non è valido, mostra un messaggio di errore o esegui un'altra operazione
                        alert('Il modulo non è valido. Controlla i campi.');

                        // Qui puoi aggiungere altro codice
                    }
                }).catch(error => {
                    console.error('Errore durante la convalida del modulo:', error);
                    alert('Si è verificato un errore durante la convalida del modulo.');
                });
            });
        });
    </script>
<style id="wpr-lazyload-bg-container"></style><style id="wpr-lazyload-bg-exclusion"></style>
<noscript>
<style id="wpr-lazyload-bg-nostyle"></style>
</noscript>
<script type="application/javascript">const rocket_pairs = []; const rocket_excluded_pairs = [];</script></head>
<body>
    <form id="myform" class="profile-form">
        <label for="name">Nome:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Invia</button>
    </form>
</body>
</html>
				
			

Convalida del modulo con jQuery e gestione asincrona

				
					
<!DOCTYPE html>
<html>
<head>
    
    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/jquery-3.6.0.min.js?ver=1793278211"></script>
    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/widgetjs/widgetjs.js?ver=1793278211" type="text/javascript"></script>
    <script>widgetJS.init('********TOKEN********');</script>
    <script>
        $(document).ready(function () {
            $('#myform').on('submit', async function (event) {
                event.preventDefault(); // Impedisce l'invio del modulo

                // Convalida il modulo
                const isFormValid = await widgetJS.isFormValid('#myform');

                if (isFormValid) {
                    // Se il modulo è valido, invialo e/o esegui altre operazioni.
                    this.submit();
                } else {
                    // Se il modulo non è valido, mostra un messaggio di errore o esegui un'altra operazione
		    // Vengono applicati anche gli stili CSS definiti nel widget.
                    alert('Il modulo non è valido. Controlla i campi.');
                }

		// Qui puoi aggiungere altro codice
            });
        });
    </script>    
<style id="wpr-lazyload-bg-container"></style><style id="wpr-lazyload-bg-exclusion"></style>
<noscript>
<style id="wpr-lazyload-bg-nostyle"></style>
</noscript>
<script type="application/javascript">const rocket_pairs = []; const rocket_excluded_pairs = [];</script></head>
<body>
    <form id="myform" class="profile-form">
        <label for="name">Nome:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Invia</button>
    </form>
</body>
</html>

				
			

Convalida del modulo con jQuery senza gestione asincrona

				
					
<!DOCTYPE html>
<html>
<head>
    
    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/jquery-3.6.0.min.js?ver=1793278211"></script>
    <script data-minify="1" src="https://www.verificaremails.com/wp-content/cache/min/1/widgetjs/widgetjs.js?ver=1793278211" type="text/javascript"></script>
    <script>widgetJS.init('********TOKEN********');</script>
    <script>
        // Esempio con jQuery
        $(document).ready(function() {
            $('#myform').on('submit', function(event) {
                event.preventDefault(); // Impedisce l'invio del modulo

                // Convalida il modulo
                widgetJS.isFormValid('#myform').then(isFormValid => {
                    if (isFormValid) {
                        // Se il modulo è valido, invialo
                        event.target.submit();
                    } else {
                        // Se il modulo non è valido, mostra un messaggio di errore o esegui un'altra operazione
                        alert('Il modulo non è valido. Controlla i campi.');


                        // Qui puoi aggiungere altro codice
                    }
                }).catch(error => {
                    console.error('Errore durante la convalida del modulo:', error);
                    alert('Si è verificato un errore durante la convalida del modulo.');
                });
            });
        });
    </script>
<style id="wpr-lazyload-bg-container"></style><style id="wpr-lazyload-bg-exclusion"></style>
<noscript>
<style id="wpr-lazyload-bg-nostyle"></style>
</noscript>
<script type="application/javascript">const rocket_pairs = []; const rocket_excluded_pairs = [];</script></head>
<body>
    <form id="myform" class="profile-form">
        <label for="name">Nome:</label>
        <input type="text" id="name" name="name" required>
        <button type="submit">Invia</button>
    </form>
</body>
</html>

				
			

Risultati della verifica nel widget

Per vedere lo stato delle verifiche vai nella sezione «APIS» del portale e seleziona l’API che hai usato nel widget. Regolando l’intervallo di tempo vedi un grafico con lo stato delle verifiche nel tempo.

Se il widget controlla più tipi di dati, apri ciascuna delle API usate:

Sezione APIS del portale con lo stato delle verifiche email

Per vedere le verifiche di ogni record, seleziona l’icona a forma di occhio nella sezione «APIS CONNESSI».

A cosa serve gestire gli eventi del widget via codice?

Gestire gli eventi del widget significa decidere tu, con poche righe di JavaScript, cosa succede quando l’utente invia un modulo: il widget verifica i campi e il tuo codice invia i dati o mostra un errore. Ti serve quando le opzioni della procedura guidata non bastano, per esempio se il modulo invia i dati via AJAX o deve eseguire altre operazioni prima dell’invio.

Come si attiva, passo dopo passo?

Per gestire gli eventi via codice disattivi nella procedura guidata l’invio automatico del modulo, inizializzi lo script del widget con il tuo token e, quando l’utente invia il modulo, chiami widgetJS.isFormValid. In base al risultato decidi tu se inviare i dati o mostrare un messaggio di errore.

  1. Nella procedura guidata del widget, al passaggio 4, disattiva «Gestisci l’invio del modulo».
  2. Includi lo script widgetjs.js e inizializzalo con il tuo token tramite widgetJS.init, come negli esempi.
  3. Intercetta l’evento submit del modulo e blocca l’invio predefinito.
  4. Chiama widgetJS.isFormValid('#myform') con il selettore del tuo modulo.
  5. Se il risultato è positivo invia il modulo; altrimenti mostra il tuo messaggio di errore.
  6. Controlla l’esito delle verifiche nella sezione «APIS» del portale.

Quale esempio scegliere?

Scegli l’esempio in base al codice che usi già nel sito. Se il modulo è scritto in JavaScript senza librerie, parti dagli esempi in JavaScript; se usi jQuery, da quelli in jQuery. Tra le versioni con e senza gestione asincrona cambia solo come attendi il risultato: con await oppure con .then().

EsempioLibreriaCome attende il risultato
JavaScript con gestione asincronaNessunaawait widgetJS.isFormValid()
JavaScript senza gestione asincronaNessuna (lo script di esempio carica anche jQuery).then() e .catch()
jQuery con gestione asincronajQueryawait widgetJS.isFormValid()
jQuery senza gestione asincronajQuery.then() e .catch()

Quando ti conviene?

Gestire gli eventi via codice ti conviene quando il comportamento standard del widget non basta: per esempio se vuoi bloccare l’invio finché i dati non sono validi, mostrare messaggi personalizzati o eseguire altre operazioni, come il tracciamento o l’invio al CRM, solo dopo che la verifica è andata a buon fine.

  • Moduli di registrazione: blocchi l’iscrizione finché email e telefono non risultano validi.
  • Moduli di contatto o preventivo: mostri un messaggio personalizzato invece dell’avviso standard.
  • Moduli con logica propria: esegui il tuo codice (tracciamento, invio al CRM) solo dopo la verifica.

Domande frequenti sugli eventi del widget

Cosa restituisce widgetJS.isFormValid?

Restituisce una promessa che, quando si risolve, indica se il modulo ha superato le verifiche configurate nel widget. Negli esempi la attendi con await oppure con .then(): se il valore è vero invii il modulo, se è falso mostri un messaggio di errore o esegui un’altra operazione.

Devo disattivare l'invio automatico del modulo?

Sì. Se vuoi gestire tu l’invio via codice, nella procedura guidata del widget devi disattivare l’opzione «Gestisci l’invio del modulo» al passaggio 4. Altrimenti è il widget a decidere se inviare i dati, secondo il comportamento che hai configurato per ogni campo.

Gli stili del widget restano attivi?

Sì. Come indicano i commenti degli esempi, quando il modulo non è valido vengono applicati anche gli stili CSS definiti nel widget, per esempio il campo evidenziato. Il tuo codice aggiunge solo la logica: decidi se inviare il modulo, mostrare un avviso o eseguire altre operazioni.

Dove vedo i risultati delle verifiche?

Nel portale, nella sezione «APIS»: selezioni l’API usata dal widget e, regolando l’intervallo di tempo, vedi un grafico con lo stato delle verifiche. Se il widget controlla più tipi di dati, apri ciascuna API. Il dettaglio di ogni record è nell’icona a forma di occhio di «APIS CONNESSI».

Hai bisogno di aiuto con le verifiche? Ti aiutiamo noi

Siamo il tuo partner di fiducia per la verifica dei tuoi dati.
Contattaci o chiama il +34 93 451 11 00