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

CKTIS / JavaScript

HTMLOptionElement.value — valor de uma opção HTML

Lê ou define o valor de uma opção HTML. Se o atributo `value` estiver ausente, é usado o texto da opção; um valor definido explicitamente como vazio mantém-se vazio.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

option.value
option.value = newValue

HTMLOptionElement.value é uma propriedade de leitura e escrita de um elemento option. A leitura devolve uma cadeia de caracteres, quer a opção esteja selecionada ou não. Se o atributo HTML value existir, a propriedade devolve o seu conteúdo, mesmo que seja "". Só na ausência do atributo é que o valor é obtido a partir do texto da opção: removem-se os caracteres de espaço em branco ASCII no início e no fim, e cada sequência interna é reduzida a um só espaço. O atributo label não é a origem deste valor alternativo.

Atribuir um valor a option.value cria ou atualiza o atributo value sem alterar o texto nem o estado de seleção da opção. option.removeAttribute("value") faz com que se volte a usar o texto. Define um valor explícito como "plan-pro" se o identificador tiver de permanecer igual mesmo quando o rótulo visível muda ou é traduzido.

Já a leitura de select.value devolve o valor da primeira opção selecionada pela ordem da árvore DOM, ou "" se não houver nenhuma. Um resultado vazio não prova, portanto, que não exista uma opção selecionada. Esta API do DOM é definida pela norma HTML e não faz parte de ECMAScript; o exemplo requer um ambiente que disponibilize o DOM HTML.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>HTMLOptionElement.value example</title>
<script>
  const option = document.createElement("option");
  option.textContent = "  Pro\n  plan  ";
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));

  option.value = "";
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));

  option.value = "plan-pro";
  console.log(JSON.stringify([option.value, option.text]));

  option.removeAttribute("value");
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));
</script>

Resultado

["Pro plan",null]
["",""]
["plan-pro","Pro plan"]
["Pro plan",null]

Guarda o exemplo como ficheiro HTML e abre-o num navegador. O resultado aparece na consola de desenvolvimento. `null` indica que o atributo está ausente, não que está vazio: na segunda linha está presente e contém `""`. Não é necessário adicionar o elemento à página.

Lições relacionadas

  • JavaScript · Lição 43 · Intermédio · Versão: 3

Fontes