CKTIS / HTML
Atributo label — um nome visível para o utilizador
O atributo label dá nome a um grupo optgroup, a uma opção ou a uma faixa track. Não é um atributo global nem substitui o elemento label. O rótulo de uma opção e o valor enviado com o formulário são conceitos distintos.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
label="text"label é um atributo de texto dos elementos optgroup, option e track, não um atributo global. Não o confunda com o elemento label, que identifica um controlo de formulário.
Em optgroup, dá nome a um grupo de opções; o próprio grupo não pode ser selecionado. O atributo é obrigatório quando o grupo não tem um elemento legend filho. Quando o primeiro filho que é um elemento é legend, o texto desse elemento tem prioridade sobre o atributo.
Em option, um label não vazio fornece o rótulo; caso contrário, este resulta do conteúdo da opção. Se for especificado, o atributo não pode estar vazio. Não substitui value: se value não existir, o valor resulta do conteúdo, não de label. Quando são especificados tanto label como value, o elemento option tem de estar vazio. O elemento selectedcontent não reflete o valor do atributo label.
Em track, o atributo fornece um título legível para a faixa na interface do leitor. É opcional, mas não pode estar vazio quando especificado; se não existir, o rótulo da faixa é uma cadeia vazia. Não especifica o idioma — essa função cabe a srclang. As faixas do mesmo elemento multimédia com o mesmo tipo e idioma não podem ter rótulos idênticos nem omitir ambas os respetivos rótulos.
Exemplos
<!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>Resultado
Orange orange
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.