Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

Atrybut label — nazwa widoczna dla użytkownika

Atrybut label nadaje nazwę grupie optgroup, opcji option lub ścieżce track. Nie jest atrybutem globalnym ani zamiennikiem elementu label. Nazwa opcji i jej wartość przesyłana w formularzu to odrębne rzeczy.

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

Składnia

label="text"

label jest tekstowym atrybutem elementów optgroup, option i track, a nie atrybutem globalnym. Nie należy mylić go z elementem label, który opisuje kontrolkę formularza.

W optgroup nazywa grupę opcji; sama grupa nie jest wybieralna. Atrybut jest wymagany, jeśli grupa nie ma dziecka legend. Gdy pierwszym dzieckiem będącym elementem jest legend, jego tekst ma pierwszeństwo przed atrybutem.

W option niepusty label określa etykietę; bez niego etykieta wynika z zawartości opcji. Podany atrybut nie może być pusty. Nie zastępuje value: przy braku value wartość wynika z zawartości, nie z label. Jeśli podano zarówno label, jak i value, element option musi być pusty. Element selectedcontent nie odzwierciedla wartości atrybutu label.

W track atrybut nadaje czytelną nazwę ścieżce w interfejsie odtwarzacza. Jest opcjonalny, ale podany nie może być pusty; bez niego etykieta ścieżki jest pustym ciągiem. Nie określa języka — służy do tego srclang. Ścieżki jednego medium o tym samym rodzaju i języku nie mogą mieć jednocześnie identycznych etykiet ani obu etykiet pominiętych.

Przykłady

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

Wynik

Orange
orange

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła