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.