Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

fieldset — agrupar controles de formulario

El elemento `fieldset` agrupa controles relacionados u otro contenido. Un `legend` opcional pone un título al grupo, mientras que `disabled` desactiva sus controles, excepto los descendientes de su primer elemento hijo `legend`.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<fieldset [disabled] [form="form-id"] [name="group-name"]>
  <legend>Group caption</legend>
  <!-- Related controls and other flow content -->
</fieldset>

fieldset representa un grupo de controles de formulario u otro contenido. Coloca un legend opcional como primer hijo elemento para poner un título al grupo. Sigue usando label para identificar cada campo. Las etiquetas de apertura y cierre son obligatorias.

La presencia de disabled desactiva los controles dentro del grupo, excepto los que están dentro de su primer hijo legend. Los controles desactivados se omiten al construir los datos del formulario. En grupos anidados, quitar un disabled interno no anula la desactivación heredada de un grupo externo.

form identifica el formulario asociado al propio fieldset; no asocia automáticamente los controles descendientes con ese formulario. name permite buscar el grupo mediante form.elements, pero no crea una entrada de nombre y valor para el grupo en los datos enviados.

El ejemplo compara los datos antes y después de establecer group.disabled = false. El control marcado en legend aparece en ambos conjuntos de datos; email aparece solo en el segundo. El código muestra el resultado en result sin enviar el formulario.

Ejemplos

<!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"]]

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes