Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

required — campo obbligatorio del modulo

L’attributo booleano `required` richiede che venga compilato un controllo del modulo supportato. Si applica a `input`, `select` e `textarea`; il modo in cui si soddisfa il requisito dipende dal tipo di controllo.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"

required è un attributo booleano: la sua presenza attiva il requisito, mentre rimuoverlo lo disattiva. Le forme required, required="" e required="required" sono equivalenti. Scrivere required="false" non è conforme e attiva comunque il requisito.

Per i controlli input di testo supportati e per textarea, un valore vuoto causa validity.valueMissing. In un normale campo di testo, anche i soli spazi possono soddisfare required; l’attributo non verifica che il contenuto sia significativo. Una checkbox obbligatoria deve essere selezionata. In un gruppo radio deve essere selezionato un elemento se uno qualsiasi ha required, mentre un controllo file richiede un file. required non si applica ai tipi hidden, range, color né ai pulsanti.

Per select, se non è selezionata alcuna opzione oppure è selezionata solo l’opzione segnaposto, il valore è considerato mancante. Un select obbligatorio senza multiple e con dimensione di visualizzazione 1 deve avere un’opzione segnaposto. Il primo elemento option nell’elenco delle opzioni deve avere un valore vuoto ed essere figlio diretto di select, senza essere annidato in un optgroup. Un’opzione con valore vuoto che compare più avanti nell’elenco non funge da segnaposto.

I controlli disabled e quelli che supportano readonly e hanno questo attributo non partecipano alla convalida dei vincoli. I controlli non validi bloccano il normale invio del modulo, ma novalidate, formnovalidate o form.submit() possono saltare questo passaggio. Convalida i dati anche sul server e indica l’obbligo in un’etichetta visibile.

L’esempio chiama checkValidity() prima e dopo aver compilato tutti e tre i controlli. Il risultato atteso è prima false, poi true; non dipende dalla lingua dei messaggi di convalida del browser.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>required</title>
<form id="form">
  <label>Name (required): <input id="name" name="name" required></label>
  <label>Plan (required):
    <select id="plan" name="plan" required>
      <option value="">Choose</option>
      <option value="basic">Basic</option>
    </select>
  </label>
  <label>Note (required): <textarea id="note" name="note" required></textarea></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('form');
  const before = form.checkValidity();
  document.getElementById('name').value = 'Ada';
  document.getElementById('plan').value = 'basic';
  document.getElementById('note').value = 'Hello';
  const after = form.checkValidity();
  document.getElementById('result').textContent = before + '\n' + after;
</script>
</html>

Risultato

false
true

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.

Fonti