CKTIS / HTML
required — задължително поле във формуляр
Булевият атрибут `required` изисква попълване на поддържан елемент за управление във формуляр. Прилага се за `input`, `select` и `textarea`; начинът за изпълнение на изискването зависи от вида на елемента.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"required е булев атрибут: наличието му включва изискването, а премахването му го изключва. Формите required, required="" и required="required" са равностойни. Записът required="false" не съответства на изискванията и въпреки това включва изискването.
При поддържаните текстови елементи input и при textarea празната стойност води до validity.valueMissing. В обикновено текстово поле само интервали могат да удовлетворят required; атрибутът не проверява дали съдържанието е смислено. Задължителната checkbox трябва да е отметната. В група radio трябва да е избран един елемент, ако който и да е от тях има required, а елементът file изисква файл. required не се прилага за типовете hidden, range, color или за бутоните.
При select стойност липсва, ако не е избрана нито една опция или ако е избрана само заместващата опция. Задължителен select без multiple и с размер на показване 1 трябва да има такава опция. Първият елемент option в списъка с опции трябва да има празна стойност и да е пряко дете на select, а не да е вложен в optgroup. Опция с празна стойност, която е по-нататък в списъка, не е заместваща опция.
Елементите disabled, както и елементите, които поддържат readonly и имат този атрибут, не участват във валидирането на ограниченията. Невалидните елементи блокират обикновеното изпращане на формуляра, но novalidate, formnovalidate или form.submit() могат да пропуснат тази стъпка. Проверявайте данните и на сървъра и обозначавайте изискването с видим етикет.
Примерът извиква checkValidity() преди и след попълването на трите елемента. Очакваният резултат е първо false, после true; той не зависи от езика на съобщенията за проверка на браузъра.
Примери
<!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>Резултат
false true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.