CKTIS / HTML
Atribut label — uporabniku vidno ime
Atribut label poimenuje skupino optgroup, možnost option ali sled track. Ni globalni atribut in ne nadomešča elementa label. Oznaka možnosti in vrednost, poslana z obrazcem, sta različna pojma.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
label="text"label je besedilni atribut elementov optgroup, option in track, ne pa globalni atribut. Ne zamenjujte ga z elementom label, ki označuje kontrolnik obrazca.
Pri optgroup poimenuje skupino možnosti; skupine same ni mogoče izbrati. Atribut je obvezen, kadar skupina nima podrejenega elementa legend. Če je prvi podrejeni element, ki je element, legend, ima njegovo besedilo prednost pred atributom.
Pri option neprazen label določa oznako; sicer oznaka izhaja iz vsebine možnosti. Če je atribut naveden, ne sme biti prazen. Ne nadomešča atributa value: če value ni naveden, vrednost izhaja iz vsebine, ne iz label. Če sta navedena tako label kot value, mora biti element option prazen. Element selectedcontent ne odraža vrednosti atributa label.
Pri track atribut določa berljiv naslov sledi v vmesniku predvajalnika. Je neobvezen, vendar ob navedbi ne sme biti prazen; brez njega je oznaka sledi prazen niz. Jezika ne določa — za to je namenjen srclang. Sledi istega predstavnega elementa z enako vrsto in jezikom ne smejo imeti enakih oznak ali obe izpuščenih oznak.
Primeri
<!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>Rezultat
Orange orange
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.