CKTIS / HTML
form — modulo HTML
L’elemento form associa i controlli a un modulo e definisce come inviarne i dati. Supporta l’invio e la convalida nativi; JavaScript può intercettare l’invio.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<form action="/search" method="get">…</form>form rappresenta un modulo i cui controlli possono fornire dati da elaborare. Sono necessari sia il tag di apertura sia quello di chiusura; i moduli non devono essere annidati. I controlli supportati che si trovano fuori dal modulo possono essere associati tramite un attributo form che fa riferimento al suo id.
action specifica la destinazione. method="get" (il valore predefinito) inserisce i dati nella query dell’URL, mentre method="post" li inserisce nel corpo della richiesta. Per caricare file con POST, usa enctype="multipart/form-data". POST da solo non fornisce cifratura.
Le chiavi dei dati provengono da name, non da id. I controlli disabilitati e le caselle non selezionate vengono omessi. Di norma vengono omessi anche i controlli senza nome, ma se si usa un pulsante di invio di tipo immagine (<input type="image">) senza nome per inviare il modulo, il pulsante aggiunge ai dati le coordinate con le chiavi x e y. Associa le etichette ai campi. La convalida del browser aiuta gli utenti, ma non sostituisce quella sul server.
Durante un normale invio, la convalida interattiva avviene prima che venga generato l’evento submit, a meno che non venga saltata. Se la convalida fallisce, l’invio si interrompe e l’evento submit non viene generato. L’attributo novalidate permette di saltare la convalida interattiva. Negli script, preferisci requestSubmit(): a differenza di submit(), mantiene la convalida e l’evento submit.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML form example</title>
</head>
<body>
<form id="search" method="get">
<label for="query">Query</label>
<input id="query" name="q" value="html" required>
<button id="submit-query" type="submit">Submit query</button>
</form>
<output id="result" for="query" aria-live="polite"></output>
<script>
const form = document.getElementById('search');
const submitButton = document.getElementById('submit-query');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const data = new FormData(form);
result.value = 'q=' + data.get('q');
console.log(result.value);
});
form.requestSubmit(submitButton);
</script>
</body>
</html>Risultato
q=html
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.