CKTIS / HTML
label-Attribut — ein sichtbarer Name
Das Attribut label benennt eine optgroup-Gruppe, eine option oder eine track-Spur. Es ist weder ein globales Attribut noch ein Ersatz für das label-Element. Das Label einer Option und ihr beim Formular übermittelter Wert sind unterschiedliche Dinge.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
label="text"label ist ein Textattribut von optgroup, option und track, kein globales Attribut. Verwechseln Sie es nicht mit dem label-Element, das ein Formularsteuerelement beschriftet.
Bei optgroup benennt es eine Gruppe von Optionen; die Gruppe selbst kann nicht ausgewählt werden. Das Attribut ist erforderlich, wenn die Gruppe kein untergeordnetes legend-Element hat. Ist legend das erste Elementkind, hat dessen Text Vorrang vor dem Attribut.
Bei option liefert ein nicht leeres label die Beschriftung; andernfalls ergibt sich die Beschriftung aus dem Inhalt der Option. Wenn das Attribut angegeben wird, darf es nicht leer sein. Es ersetzt value nicht: Fehlt value, ergibt sich der Wert aus dem Inhalt, nicht aus label. Sind sowohl label als auch value angegeben, muss das option-Element leer sein. Das selectedcontent-Element bildet den Wert des label-Attributs nicht ab.
Bei track liefert das Attribut einen lesbaren Spurtitel in der Player-Oberfläche. Es ist optional, darf aber bei Angabe nicht leer sein; ohne das Attribut ist die Spurbeschriftung eine leere Zeichenfolge. Es legt nicht die Sprache fest — dafür ist srclang zuständig. Spuren eines Medienelements mit derselben Art und Sprache dürfen nicht zugleich identische Beschriftungen haben oder beide ohne Beschriftung sein.
Beispiele
<!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>Ergebnis
Orange orange
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.