CKTIS / HTML
fieldset — formulierbesturingselementen groeperen
Het element `fieldset` groepeert verwante besturingselementen of andere inhoud. Een optionele `legend` geeft de groep een bijschrift; `disabled` schakelt de besturingselementen uit, behalve afstammelingen van het eerste `legend`-kind.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<fieldset [disabled] [form="form-id"] [name="group-name"]>
<legend>Group caption</legend>
<!-- Related controls and other flow content -->
</fieldset>fieldset stelt een groep formulierbesturingselementen of andere inhoud voor. Plaats een optionele legend als eerste elementkind om de groep een bijschrift te geven. Gebruik label nog steeds om afzonderlijke velden aan te duiden. Zowel de openings- als de sluitingstag is vereist.
Als disabled aanwezig is, worden besturingselementen binnen de groep uitgeschakeld, behalve die binnen het eerste legend-kind. Uitgeschakelde besturingselementen worden weggelaten bij het samenstellen van formuliergegevens. In geneste groepen maakt het verwijderen van een interne disabled de uitschakeling door een buitenste groep niet ongedaan.
form identificeert het formulier dat aan het fieldset zelf is gekoppeld; hiermee worden besturingselementen van afstammelingen niet automatisch aan dat formulier gekoppeld. Met name kun je de groep vinden via form.elements, maar er wordt geen naam-waarde-invoer voor de groep gemaakt in de verzonden gegevens.
Het voorbeeld vergelijkt de gegevens vóór en na het instellen van group.disabled = false. Het aangevinkte besturingselement in legend staat in beide gegevensverzamelingen; email alleen in de tweede. De code toont het resultaat in result zonder het formulier te verzenden.
Voorbeelden
<!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>Resultaat
[["enabled","on"]] [["enabled","on"],["email","ada@example.com"]]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.