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.