Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

Atribut label — název viditelný pro uživatele

Atribut label pojmenovává skupinu optgroup, možnost option nebo stopu track. Není globálním atributem ani náhradou za element label. Popisek možnosti a její hodnota odeslaná ve formuláři jsou dvě různé věci.

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

Syntaxe

label="text"

label je textový atribut elementů optgroup, option a track, nikoli globální atribut. Nezaměňujte ho s elementem label, který popisuje ovládací prvek formuláře.

U optgroup pojmenovává skupinu možností; samotnou skupinu nelze vybrat. Atribut je povinný, pokud skupina nemá potomka legend. Pokud je prvním potomkem, který je elementem, legend, má jeho text před atributem přednost.

U option poskytuje neprázdný label popisek; jinak popisek vychází z obsahu možnosti. Je-li atribut uveden, nesmí být prázdný. Nenahrazuje value: bez value vychází hodnota z obsahu, nikoli z label. Jsou-li uvedeny oba atributy label i value, musí být element option prázdný. Element selectedcontent hodnotu atributu label neodráží.

U track poskytuje atribut čitelný název stopy v rozhraní přehrávače. Je volitelný, ale při uvedení nesmí být prázdný; bez něj je popisek stopy prázdný řetězec. Jazyk neurčuje — k tomu slouží srclang. Stopy jednoho mediálního elementu se stejným druhem a jazykem nesmějí mít zároveň stejné popisky ani obě popisky vynechané.

Příklady

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

Výsledek

Orange
orange

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje