Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

required — povinné pole formuláře

Logický atribut `required` vyžaduje vyplnění podporovaného ovládacího prvku formuláře. Platí pro `input`, `select` a `textarea`; způsob splnění požadavku závisí na typu ovládacího prvku.

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

Syntaxe

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

required je logický atribut: jeho přítomnost požadavek zapíná a jeho odstranění jej vypíná. Zápisy required, required="" a required="required" jsou rovnocenné. Zápis required="false" není v souladu se specifikací a požadavek přesto zapíná.

U podporovaných textových prvků input a u textarea způsobí prázdná hodnota validity.valueMissing. V běžném textovém poli mohou požadavek required splnit i samotné mezery; atribut nekontroluje smysluplnost obsahu. Povinný checkbox musí být zaškrtnutý. Ve skupině radio musí být vybrán jeden prvek, pokud má některý z nich required, a ovládací prvek file vyžaduje soubor. required se nevztahuje na typy hidden, range, color ani na tlačítka.

U select hodnota chybí, pokud není vybrána žádná možnost nebo je vybrána pouze zástupná možnost. Povinný select bez multiple a s velikostí zobrazení 1 musí takovou možnost mít. První prvek option v seznamu možností musí mít prázdnou hodnotu a být přímým potomkem select, nikoli být vnořený do optgroup. Možnost s prázdnou hodnotou na pozdější pozici v seznamu není zástupnou možností.

Ovládací prvky disabled a ovládací prvky podporující readonly, které mají tento atribut, se neúčastní validace omezení. Neplatné ovládací prvky blokují běžné odeslání formuláře, ale novalidate, formnovalidate nebo form.submit() mohou tento krok obejít. Data ověřujte také na serveru a povinnost uveďte ve viditelném popisku.

Příklad volá checkValidity() před vyplněním všech tří ovládacích prvků i po něm. Očekávaný výstup je nejprve false a poté true; nezávisí na jazyce validačních zpráv prohlížeče.

Příklady

<!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>

Výsledek

false
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje