KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

legend — groepsbijschrift

Het element `legend` geeft een groep in `fieldset` een bijschrift of labelt een optiegroep in `optgroup`. Het moet het eerste elementkind zijn en vervangt niet de labels van afzonderlijke bedieningselementen.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

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

Een legend als eerste elementkind van fieldset geeft bijschrift aan de overige inhoud van de groep. Gebruik het voor een gezamenlijke vraag of groepsnaam en gebruik label voor afzonderlijke bedieningselementen.

Beide tags zijn vereist. Het element accepteert globale attributen. Binnen fieldset kan het tekstinhoud bevatten, zoals tekst en nadruk, eventueel afgewisseld met koppen. Het is geen onbeperkte blokcontainer.

legend is ook toegestaan als eerste elementkind van optgroup, waar het het label van de optiegroep levert. In die context is alleen tekstinhoud toegestaan, zonder interactieve inhoud en zonder afstammelingen met een tabindex-attribuut.

Als een fieldset disabled heeft, geldt die uitschakeling niet voor bedieningselementen binnen het eerste legend-kind; andere oorzaken kunnen ze nog steeds uitschakelen. De alleen-lezen DOM-eigenschap legend.form geeft het formulier van de bovenliggende fieldset terug of null; zonder zo’n bovenliggend element geeft de eigenschap ook null terug.

Voorbeelden

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

Resultaat

Contact method
preferences

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.

Bronnen