CKTIS / HTML
Attributo label — un nome visibile all’utente
L’attributo label assegna un nome a un gruppo optgroup, a un’opzione o a una traccia track. Non è un attributo globale né sostituisce l’elemento label. L’etichetta di un’opzione e il valore inviato con il modulo sono concetti distinti.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
label="text"label è un attributo testuale di optgroup, option e track, non un attributo globale. Non va confuso con l’elemento label, che descrive un controllo del modulo.
Su optgroup, assegna un nome a un gruppo di opzioni; il gruppo in sé non è selezionabile. L’attributo è obbligatorio se il gruppo non ha un elemento legend figlio. Se il primo figlio che è un elemento è legend, il suo testo ha la precedenza sull’attributo.
Su option, un label non vuoto fornisce l’etichetta; altrimenti, questa deriva dal contenuto dell’opzione. Se specificato, l’attributo non deve essere vuoto. Non sostituisce value: se value manca, il valore deriva dal contenuto, non da label. Se sono specificati sia label sia value, l’elemento option deve essere vuoto. L’elemento selectedcontent non riflette il valore dell’attributo label.
Su track, l’attributo fornisce un titolo leggibile della traccia nell’interfaccia del lettore. È facoltativo, ma se specificato non deve essere vuoto; se manca, l’etichetta della traccia è una stringa vuota. Non specifica la lingua: questo è il compito di srclang. Le tracce dello stesso elemento multimediale con lo stesso tipo e la stessa lingua non devono avere etichette identiche né omettere entrambe l’etichetta.
Esempi
<!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>Risultato
Orange orange
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.