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

CKTIS / HTML

option — uma opção HTML

O elemento option define uma opção em select ou uma sugestão em datalist. Separa o rótulo do valor e permite definir uma seleção predefinida e opções desativadas.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<option value="value" selected disabled>Label</option>

option representa uma opção em select ou uma sugestão em datalist; optgroup agrupa opções. Uma sugestão, por si só, não restringe o texto introduzido aos valores disponíveis.

value especifica o valor da opção; se o atributo estiver ausente, o valor é obtido a partir do texto. Um label não vazio fornece o rótulo; caso contrário, este provém do conteúdo textual. Para uma lista convencional, basta texto simples.

O atributo booleano selected especifica a seleção predefinida, refletida por defaultSelected. A propriedade JavaScript selected representa o estado atual. Se select não tiver multiple, não assinale mais do que uma opção com o atributo selected.

disabled impede a seleção pelo utilizador, incluindo quando o estado é herdado de um optgroup ascendente; não impede alterações programáticas. No exemplo, o rótulo apresentado é Medium, enquanto o valor é m.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Option example</title>
<label for="size">Size</label>
<select id="size" name="size">
  <option value="s">Small</option>
  <option value="m" selected>Medium</option>
  <option value="l" disabled>Large</option>
</select>
<pre id="result"></pre>
<script>
  const select = document.getElementById('size');
  const option = select.options[1];
  document.getElementById('result').textContent =
    `${select.value}\n${option.text}\n${option.selected}\n${option.defaultSelected}`;
</script>
</html>

Resultado

m
Medium
true
true

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