Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes