Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

required — wymagane pole formularza

Atrybut logiczny `required` wymaga uzupełnienia obsługiwanej kontrolki formularza. Dotyczy `input`, `select` i `textarea`; sposób spełnienia wymagania zależy od rodzaju kontrolki.

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

Składnia

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

required jest atrybutem logicznym: jego obecność włącza wymaganie, a usunięcie je wyłącza. Zapisy required, required="" i required="required" są równoważne. Zapis required="false" jest niepoprawny i nadal włącza wymaganie.

Dla obsługiwanych pól tekstowych input i dla textarea pusta wartość powoduje validity.valueMissing. Same spacje mogą spełnić required w zwykłym polu tekstowym; atrybut nie sprawdza sensowności treści. Wymagany checkbox musi być zaznaczony, grupa radio wymaga zaznaczenia jednego elementu, jeśli którykolwiek ma required, a pole file wymaga pliku. required nie dotyczy typów hidden, range, color ani przycisków.

W select brak zaznaczenia lub zaznaczenie wyłącznie opcji zastępczej oznacza brak wartości. Wymagany select bez multiple, o rozmiarze wyświetlania 1, musi mieć taką opcję. Pierwszy element option na liście opcji musi mieć pustą wartość i być bezpośrednim dzieckiem select, a nie znajdować się w optgroup. Opcja z pustą wartością na dalszej pozycji nie jest opcją zastępczą.

Kontrolki disabled oraz obsługujące readonly kontrolki z tym atrybutem nie uczestniczą w walidacji ograniczeń. Zwykłe wysłanie formularza jest blokowane przez niepoprawne kontrolki, ale novalidate, formnovalidate lub form.submit() mogą ominąć ten etap. Sprawdzaj dane również na serwerze; oznacz wymaganie w widocznej etykiecie.

Przykład używa checkValidity() przed wypełnieniem trzech kontrolek i po nim. Oczekiwany wynik to false, następnie true; nie zależy on od języka komunikatów walidacyjnych przeglądarki.

Przykłady

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

Wynik

false
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła