CKTIS / JavaScript
Moduli e validità
Usa `input` per reagire alle modifiche di un campo e `submit` per gestire l’invio del modulo dopo che la convalida standard è andata a buon fine. `HTMLFormElement` offre anche metodi per verificare esplicitamente la validità del modulo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();HTMLFormElement è l’interfaccia del DOM del browser che rappresenta un elemento form. La proprietà form.elements dà accesso ai controlli associati al modulo. È un’API Web, non una parte del linguaggio ECMAScript.
Ascolta l’evento input per reagire alle modifiche dell’utente, ad esempio per aggiornare un suggerimento mentre scrive. Assegnare un valore a field.value in JavaScript non genera di per sé l’evento input. L’attributo required rende non valido un campo di testo vuoto. form.checkValidity() restituisce il risultato come valore booleano. Anche form.reportValidity() restituisce un valore booleano e mostra all’utente gli errori di convalida, a meno che non venga annullato l’evento invalid del controllo interessato. L’annullamento di quell’evento non cambia il risultato della convalida: il metodo restituisce false senza mostrare un errore per quel controllo.
Durante un normale tentativo di invio, il browser verifica prima i vincoli. Se un campo non è valido, il browser blocca l’invio e l’evento submit non viene generato. Se la convalida va a buon fine, submit viene generato sul modulo, non sul pulsante. Chiamare event.preventDefault() nel gestore dell’evento annulla l’invio predefinito.
Usa form.requestSubmit() per avviare lo stesso processo dal codice. Chiamare direttamente form.submit() salta sia la convalida sia l’evento submit. La convalida nel browser aiuta gli utenti a correggere i dati inseriti, ma non sostituisce la convalida lato server.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
<label>Name <input name="displayName" required></label>
<button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
const form = document.querySelector('#profile');
const field = form.elements.namedItem('displayName');
const log = document.querySelector('#log');
const append = (line) => { log.textContent += line + '\n'; };
field.addEventListener('input', () => {
append(`input: ${form.checkValidity()}`);
});
form.addEventListener('submit', (event) => {
event.preventDefault();
append(`submit: ${field.value}`);
});
append(`initial: ${form.checkValidity()}`);
</script>Risultato
initial: false input: true submit: A
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.