Principio di validazione
tikento utilizza una validazione a due livelli:
- Lato client (blur) — verifica alla perdita del focus dal campo. Feedback immediato per il partecipante.
- Lato server (backend) — verifica ripetuta all'invio del modulo. Garantisce la correttezza dei dati.
Il backend e l'unica fonte di verita. Anche se la validazione lato client viene aggirata, il server rifiutera i dati non corretti.
Regole integrate per tipo di campo
Per ciascuno dei 14 tipi di campi sono previste regole standard:
| Tipo di campo | Validazione integrata |
|---|---|
| Formato email (RFC 5322), verifica regex | |
| Telefono | Formato telefonico, regex internazionale |
| Testo | Lunghezza minima/massima |
| Numero | Valore minimo/massimo |
| Data | Data valida, limiti dell'intervallo |
| URL | Formato URL |
| Menu a tendina | Valore tra le opzioni ammesse |
| Radio | Valore tra le opzioni ammesse |
| Casella di controllo | Spunta obbligatoria (per consensi) |
| File | Tipo e dimensione del file |
Configurazione della validazione
Obbligatorieta del campo
Interruttore «Campo obbligatorio» nelle impostazioni del campo. Se attivato, il partecipante non potra inviare il modulo senza compilare questo campo.
Pattern regex
Per i campi di testo puo impostare un'espressione regolare per la verifica del formato di inserimento:
- Apra le impostazioni del campo nel costruttore del modulo.
- Trovi la sezione «Validazione».
- Nel campo «Pattern regex» inserisca l'espressione regolare.
- Nel campo «Messaggio di errore» indichi il testo che vedra il partecipante in caso di non conformita.
Esempi:
- Codice fiscale (12 cifre):
^\d{12}$ - Serie e numero del passaporto:
^\d{4}\s?\d{6}$ - Solo caratteri cirillici:
^[a-zA-ZaeE\s-]+$
Minimo e massimo
Per i campi numerici imposti i limiti:
- min — valore minimo ammesso
- max — valore massimo ammesso
Per i campi di testo:
- minLength — lunghezza minima del testo
- maxLength — lunghezza massima del testo
Validazione blur
La validazione scatta nel momento in cui il partecipante lascia il campo (perde il focus). Questo fornisce un feedback immediato:
- Il campo viene evidenziato in rosso
- Sotto il campo appare un messaggio di errore
- Il partecipante puo correggere immediatamente l'inserimento
Tornando al campo e correggendo l'errore, l'evidenziazione e il messaggio scompaiono.
Messaggi localizzati
Tutti i messaggi di errore standard sono tradotti nelle lingue supportate (ru, en, es, ar, it, de, fr). Il partecipante vede il messaggio nella lingua del modulo.
Per i messaggi personalizzati puo indicare la traduzione per ciascuna lingua:
- Nelle impostazioni del campo apra la sezione «Validazione».
- Prema l'icona di traduzione accanto al campo «Messaggio di errore».
- Compili i testi per le lingue desiderate.
Se la traduzione non e indicata, viene utilizzata la catena di fallback: lingua richiesta, russo, inglese, chiave dell'errore.
Validazione nella navigazione tra passaggi
Nei moduli a piu passaggi la validazione viene eseguita prima del passaggio al passo successivo. Il partecipante non potra procedere finche tutti i campi obbligatori del passo corrente non saranno compilati correttamente.