WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen