CKTIS / HTML
required — povinné pole formulára
Logický atribút `required` vyžaduje vyplnenie podporovaného ovládacieho prvku formulára. Platí pre `input`, `select` a `textarea`; spôsob splnenia požiadavky závisí od typu ovládacieho prvku.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"required je logický atribút: jeho prítomnosť požiadavku zapína a jeho odstránenie ju vypína. Zápisy required, required="" a required="required" sú rovnocenné. Zápis required="false" nie je v súlade so špecifikáciou a požiadavku napriek tomu zapína.
V podporovaných textových prvkoch input a v prvku textarea spôsobí prázdna hodnota validity.valueMissing. V bežnom textovom poli môžu požiadavku required splniť aj samotné medzery; atribút nekontroluje zmysluplnosť obsahu. Povinný checkbox musí byť zaškrtnutý. V skupine radio musí byť vybratý jeden prvok, ak má niektorý z nich required, a ovládací prvok file vyžaduje súbor. required sa nevzťahuje na typy hidden, range, color ani na tlačidlá.
Pri select hodnota chýba, ak nie je vybratá žiadna možnosť alebo je vybratá iba zástupná možnosť. Povinný select bez multiple a s veľkosťou zobrazenia 1 musí mať takúto možnosť. Prvý prvok option v zozname možností musí mať prázdnu hodnotu a byť priamym potomkom select, nie byť vnorený do optgroup. Možnosť s prázdnou hodnotou na neskoršej pozícii v zozname nie je zástupnou možnosťou.
Ovládacie prvky disabled a ovládacie prvky podporujúce readonly, ktoré majú tento atribút, sa nezúčastňujú na validácii obmedzení. Neplatné ovládacie prvky blokujú bežné odoslanie formulára, ale novalidate, formnovalidate alebo form.submit() môžu tento krok obísť. Údaje overujte aj na serveri a povinnosť uveďte vo viditeľnom popise.
Príklad volá checkValidity() pred vyplnením všetkých troch ovládacích prvkov aj po ňom. Očakávaný výstup je najprv false a potom true; nezávisí od jazyka validačných správ prehliadača.
Prí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ýsledok
false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.