CKTIS / HTML
fieldset — agrupar controlos de formulário
O elemento `fieldset` agrupa controlos relacionados ou outro conteúdo. Um `legend` opcional dá um título ao grupo, enquanto `disabled` desativa os controlos, exceto os descendentes do seu primeiro elemento filho `legend`.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<fieldset [disabled] [form="form-id"] [name="group-name"]>
<legend>Group caption</legend>
<!-- Related controls and other flow content -->
</fieldset>fieldset representa um grupo de controlos de formulário ou outro conteúdo. Coloque um legend opcional como primeiro elemento filho para dar um título ao grupo. Continue a usar label para identificar os campos individuais. As etiquetas de abertura e fecho são obrigatórias.
A presença de disabled desativa os controlos dentro do grupo, exceto os que estão no seu primeiro elemento filho legend. Os controlos desativados são omitidos quando os dados do formulário são construídos. Em grupos aninhados, remover um disabled interno não anula a desativação herdada de um grupo externo.
form identifica o formulário associado ao próprio fieldset; não associa automaticamente os controlos descendentes a esse formulário. name permite localizar o grupo através de form.elements, mas não cria uma entrada nome-valor para o grupo nos dados enviados.
O exemplo compara os dados antes e depois de definir group.disabled = false. O controlo assinalado em legend aparece em ambos os conjuntos de dados; email aparece apenas no segundo. O código apresenta o resultado em result sem submeter o formulário.
Exemplos
<!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>Resultado
[["enabled","on"]] [["enabled","on"],["email","ada@example.com"]]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.