CKTIS / HTML
fieldset — групиране на контроли на формуляр
Елементът `fieldset` групира свързани контроли или друго съдържание. Незадължителен `legend` дава заглавие на групата, а `disabled` деактивира контролите ѝ, с изключение на потомците на първия ѝ пряк дъщерен елемент `legend`.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<fieldset [disabled] [form="form-id"] [name="group-name"]>
<legend>Group caption</legend>
<!-- Related controls and other flow content -->
</fieldset>fieldset представя група от контроли на формуляр или друго съдържание. Ако използвате legend за заглавие на групата, поставете го като първи дъщерен елемент. Продължавайте да използвате label за обозначаване на отделните полета. Отварящият и затварящият таг са задължителни.
Наличието на disabled деактивира контролите в групата, с изключение на тези в първия ѝ пряк дъщерен елемент legend. Деактивираните контроли не се включват в данните на формуляра. При вложени групи премахването на disabled от вътрешната група не активира контролите, които остават деактивирани заради външна група.
form указва по идентификатор формуляра, свързан със самия fieldset, но не свързва автоматично контролите в групата с този формуляр. name позволява групата да бъде намерена чрез form.elements, но не създава двойка име–стойност за групата в изпратените данни.
Примерът сравнява данните преди и след задаването на group.disabled = false. Отметнатото поле в legend присъства и в двата набора от данни, а полето email — само във втория. Кодът показва резултата в result, без да изпраща формуляра.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>fieldset example</title>
<form id="settings">
<fieldset id="group" disabled>
<legend><label><input type="checkbox" name="enabled" checked> Notifications</label></legend>
<label>Email <input type="email" name="email" value="ada@example.com"></label>
</fieldset>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('settings');
const group = document.getElementById('group');
const snapshot = () => JSON.stringify([...new FormData(form)]);
const before = snapshot();
group.disabled = false;
document.getElementById('result').textContent =
before + '\n' + snapshot();
</script>
</html>Резултат
[["enabled","on"]] [["enabled","on"],["email","ada@example.com"]]
Показаният код и посоченият резултат са проверени в изолирана среда по метода, документиран за проверката на тази конкретна версия.