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

CKTIS / HTML

legend — título del grupo

El elemento `legend` titula un grupo en `fieldset` o etiqueta un grupo de opciones en `optgroup`. Debe ser el primer elemento hijo y no sustituye las etiquetas de los controles individuales.

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

Sintaxis

<fieldset>
  <legend>Group caption</legend>
  <!-- Group contents -->
</fieldset>

Un elemento legend situado como primer elemento hijo de fieldset titula el resto del contenido del grupo. Úsalo para una pregunta común o el nombre del grupo, y usa label para los controles individuales.

Ambas etiquetas son necesarias. El elemento acepta atributos globales. Dentro de fieldset, puede contener contenido de frase, como texto y énfasis, opcionalmente intercalado con encabezados. No es un contenedor de bloque sin restricciones.

legend también está permitido como primer elemento hijo de optgroup, donde proporciona la etiqueta del grupo de opciones. En ese contexto, solo se permite contenido de frase; no se permite contenido interactivo ni descendientes con un atributo tabindex.

Cuando un fieldset tiene disabled, esa desactivación no afecta a los controles que están dentro de su primer hijo legend; otras causas sí pueden desactivarlos. La propiedad DOM de solo lectura legend.form devuelve el formulario del fieldset padre o null; si no existe tal padre, también devuelve null.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Legend example</title>
<form id="preferences">
  <fieldset>
    <legend id="caption">Contact method</legend>
    <label><input type="radio" name="contact" value="email" checked> Email</label>
    <label><input type="radio" name="contact" value="phone"> Phone</label>
  </fieldset>
</form>
<script>
  const caption = document.getElementById('caption');
  console.log(caption.textContent);
  console.log(caption.form.id);
</script>
</html>

Resultado

Contact method
preferences

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