KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

Het label-attribuut — een zichtbare naam

Het label-attribuut geeft een naam aan een optgroup-groep, een option of een track. Het is geen globaal attribuut en vervangt het label-element niet. Het label van een optie en de waarde die met het formulier wordt verzonden, zijn verschillende begrippen.

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

Syntax

label="text"

label is een tekstattribuut van optgroup, option en track, geen globaal attribuut. Verwar het niet met het label-element, dat een formulierbesturingselement beschrijft.

Bij optgroup geeft het een groep opties een naam; de groep zelf kan niet worden geselecteerd. Het attribuut is verplicht als de groep geen onderliggend legend-element heeft. Is legend het eerste elementkind, dan heeft de tekst daarvan voorrang op het attribuut.

Bij option levert een niet-lege label het label; anders komt het label uit de inhoud van de optie. Als het attribuut is opgegeven, mag het niet leeg zijn. Het vervangt value niet: zonder value komt de waarde uit de inhoud, niet uit label. Als zowel label als value zijn opgegeven, moet het option-element leeg zijn. Het selectedcontent-element geeft de waarde van het label-attribuut niet weer.

Bij track levert het attribuut een leesbare tracktitel in de spelerinterface. Het is optioneel, maar mag niet leeg zijn als het is opgegeven; zonder attribuut is het tracklabel een lege tekenreeks. Het geeft de taal niet aan — daarvoor dient srclang. Tracks van één media-element met hetzelfde type en dezelfde taal mogen niet ook identieke labels hebben of allebei hun label weglaten.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Label attribute</title>
<label for="fruit">Fruit</label>
<select id="fruit" name="fruit">
  <optgroup label="Citrus">
    <option label="Orange" value="orange" selected></option>
  </optgroup>
</select>
<pre id="result"></pre>
<script>
  const select = document.getElementById('fruit');
  const option = select.options[0];
  document.getElementById('result').textContent =
    option.label + '\n' + select.value;
</script>
</html>

Resultaat

Orange
orange

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