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.