CKTIS / HTML
required — verplicht formulierveld
Het booleaanse attribuut `required` vereist dat een ondersteund besturingselement van een formulier wordt ingevuld. Het geldt voor `input`, `select` en `textarea`; hoe aan de eis wordt voldaan, hangt af van het type besturingselement.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"required is een booleaans attribuut: aanwezigheid ervan schakelt de eis in en verwijdering schakelt die uit. De schrijfwijzen required, required="" en required="required" zijn gelijkwaardig. required="false" schrijven is niet conform en schakelt de eis nog steeds in.
Bij ondersteunde tekstinvoer-input-elementen en bij textarea leidt een lege waarde tot validity.valueMissing. In een gewoon tekstveld kunnen alleen spaties al voldoen aan required; het attribuut controleert niet of de inhoud betekenisvol is. Een verplichte checkbox moet aangevinkt zijn. In een radio-groep moet één element aangevinkt zijn als een element required heeft, en een file-besturingselement vereist een bestand. required geldt niet voor de typen hidden, range, color of knoppen.
Bij select ontbreekt een waarde als er niets is geselecteerd of als alleen de placeholderoptie is geselecteerd. Een verplichte select zonder multiple en met weergavegrootte 1 moet zo’n placeholderoptie hebben. Het eerste option-element in de lijst met opties moet een lege waarde hebben en rechtstreeks onder select staan, dus niet binnen een optgroup. Een optie met een lege waarde die verderop in de lijst staat, geldt niet als placeholderoptie.
disabled-besturingselementen en besturingselementen die readonly ondersteunen en dat attribuut hebben, nemen niet deel aan beperkingsvalidatie. Ongeldige besturingselementen blokkeren een gewone formulierverzending, maar novalidate, formnovalidate of form.submit() kunnen deze stap overslaan. Controleer gegevens ook op de server en geef de verplichting aan in een zichtbaar label.
Het voorbeeld roept checkValidity() aan voordat en nadat alle drie de besturingselementen zijn ingevuld. De verwachte uitvoer is eerst false en daarna true; dit hangt niet af van de taal van de validatiemeldingen van de browser.
Voorbeelden
<!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>Resultaat
false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.