WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

required — Pflichtfeld im Formular

Das boolesche Attribut `required` verlangt, dass ein unterstütztes Formularsteuerelement ausgefüllt wird. Es gilt für `input`, `select` und `textarea`; wie die Anforderung erfüllt wird, hängt vom Typ des Steuerelements ab.

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

Syntax

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

required ist ein boolesches Attribut: Ist es vorhanden, wird die Anforderung aktiviert; wird es entfernt, ist sie deaktiviert. Die Schreibweisen required, required="" und required="required" sind gleichwertig. required="false" ist nicht konform und aktiviert die Anforderung trotzdem.

Bei unterstützten Texteingabe-input-Elementen und bei textarea führt ein leerer Wert zu validity.valueMissing. In einem gewöhnlichen Textfeld können bereits Leerzeichen required erfüllen; das Attribut prüft nicht, ob der Inhalt sinnvoll ist. Eine erforderliche checkbox muss angekreuzt sein. Bei einer radio-Gruppe muss ein Element ausgewählt sein, wenn irgendein Element der Gruppe required hat; ein file-Steuerelement benötigt eine Datei. required gilt nicht für die Typen hidden, range, color oder Schaltflächen.

Bei select bedeutet keine Auswahl oder die Auswahl ausschließlich der Platzhalter-Labeloption, dass ein Wert fehlt. Ein erforderliches select ohne multiple und mit Anzeigegröße 1 muss einen solchen Platzhalter haben. Das erste option-Element in der Optionsliste muss einen leeren Wert haben und ein direktes Kind von select sein, also nicht in einem optgroup stehen. Eine Option mit leerem Wert an späterer Stelle in der Liste gilt nicht als Platzhalter-Labeloption.

disabled-Steuerelemente und Steuerelemente, die readonly unterstützen und dieses Attribut haben, nehmen nicht an der Einschränkungsvalidierung teil. Eine normale Formularübermittlung wird durch ungültige Steuerelemente verhindert; novalidate, formnovalidate oder form.submit() können diesen Schritt jedoch umgehen. Prüfen Sie die Daten auch auf dem Server und weisen Sie in einer sichtbaren Beschriftung auf die Pflicht hin.

Das Beispiel ruft checkValidity() vor und nach dem Ausfüllen aller drei Steuerelemente auf. Erwartet wird zuerst false, dann true; das Ergebnis hängt nicht von der Sprache der Validierungsmeldungen des Browsers ab.

Beispiele

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

Ergebnis

false
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen