CKTIS / HTML
onsubmit — gestire un tentativo di invio del modulo
L’attributo onsubmit specifica il codice JavaScript che gestisce l’evento submit. Consente di reagire a un tentativo di invio del modulo e di annullare l’invio predefinito; non conferma che i dati siano arrivati al server.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };onsubmit è un attributo per la gestione dell’evento submit. Normalmente si trova sull’elemento form, non sul pulsante di invio. Sebbene sia disponibile su tutti gli elementi HTML, il modulo è il destinatario di questo evento, che si propaga agli elementi antenati. Il valore dell’attributo è codice JavaScript, non l’indirizzo di destinazione del modulo.
L’evento si verifica prima dell’invio predefinito, per esempio dopo aver attivato un pulsante di invio o aver chiamato form.requestSubmit(). Se il browser esegue la convalida dei vincoli e il modulo non la supera, l’evento submit non si verifica. Il metodo form.submit() ignora sia questa convalida sia l’evento submit.
Il codice dell’attributo riceve il parametro event. Chiamare event.preventDefault() o eseguire return false annulla l’invio predefinito. Questo non interrompe la propagazione dell’evento. Chiamare semplicemente una funzione che restituisce false, senza inoltrarne il risultato con return, non annulla l’invio.
JavaScript può anche assegnare una funzione a form.onsubmit; un’assegnazione successiva sostituisce la funzione precedente per questa proprietà. L’esempio usa l’attributo, annulla l’invio e modifica il testo di stato. JavaScript deve essere abilitato e la policy di sicurezza deve consentire i gestori di eventi inline.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsubmit demo</title>
<form onsubmit="event.preventDefault(); document.getElementById('result').textContent = 'Submission canceled';">
<button type="submit">Submit</button>
</form>
<p id="result" role="status">Ready</p>
</html>Risultato
Submission canceled
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.