Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

required — obvezno polje obrazca

Logični atribut `required` zahteva, da je podprt kontrolnik obrazca izpolnjen. Velja za `input`, `select` in `textarea`; način izpolnitve zahteve je odvisen od vrste kontrolnika.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

required je logični atribut: njegova prisotnost vključi zahtevo, odstranitev pa jo izključi. Zapisi required, required="" in required="required" so enakovredni. Zapis required="false" ni skladen in kljub temu vključi zahtevo.

Pri podprtih besedilnih kontrolnikih input in pri textarea prazna vrednost povzroči validity.valueMissing. V navadnem besedilnem polju lahko zahtevo required izpolnijo že sami presledki; atribut ne preverja, ali je vsebina smiselna. Obvezni checkbox mora biti označen. V skupini radio mora biti izbran en element, če ima kateri koli element required, kontrolnik file pa potrebuje datoteko. required ne velja za tipe hidden, range, color ali gumbe.

Pri select vrednost manjka, če ni izbrana nobena možnost ali če je izbrana le nadomestna možnost. Obvezni select brez multiple in z velikostjo prikaza 1 mora imeti takšno možnost. Prvi element option na seznamu možnosti mora imeti prazno vrednost in biti neposredni otrok elementa select, ne pa biti vgnezden v optgroup. Možnost s prazno vrednostjo, ki je na seznamu nižje, ni nadomestna možnost.

Kontrolniki disabled in kontrolniki, ki podpirajo readonly ter imajo ta atribut, ne sodelujejo pri preverjanju omejitev. Neveljavni kontrolniki preprečijo običajno pošiljanje obrazca, vendar lahko novalidate, formnovalidate ali form.submit() ta korak zaobidejo. Podatke preverite tudi na strežniku in zahtevo označite v vidni oznaki.

Primer pokliče checkValidity() pred izpolnitvijo vseh treh kontrolnikov in po njej. Pričakovani rezultat je najprej false, nato true; ni odvisen od jezika sporočil brskalnika o preverjanju veljavnosti.

Primeri

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

Rezultat

false
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri