Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLOptionElement.value — valore di un’opzione HTML

Leggi o imposta il valore di una singola opzione HTML. Se manca l’attributo `value`, si usa il testo dell’opzione; se il valore è esplicitamente vuoto, rimane tale.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

option.value
option.value = newValue

HTMLOptionElement.value è una proprietà di lettura e scrittura di un singolo elemento option. La lettura restituisce una stringa, a prescindere dal fatto che l’opzione sia selezionata. Se l’attributo HTML value è presente, la proprietà ne restituisce il contenuto, anche quando è "". Solo in assenza dell’attributo il valore si ricava dal testo dell’opzione: i caratteri di spaziatura ASCII all’inizio e alla fine vengono rimossi, e ogni sequenza interna viene ridotta a un solo spazio. L’attributo label non è la fonte di questo valore alternativo.

Assegnare un valore a option.value crea o aggiorna l’attributo value senza modificare il testo dell’opzione né il suo stato di selezione. option.removeAttribute("value") ripristina l’uso del testo. Imposta un valore esplicito come "plan-pro" se l’identificatore deve restare invariato anche quando l’etichetta visibile cambia o viene tradotta.

La lettura di select.value, invece, restituisce il valore della prima opzione selezionata nell’ordine dell’albero DOM, oppure "" se non è selezionata alcuna opzione. Un risultato vuoto non dimostra quindi che non ci sia alcuna selezione. Questa API del DOM è definita dallo standard HTML, non da ECMAScript; l’esempio richiede un ambiente che fornisca il DOM HTML.

Esempi

<!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>

Risultato

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

Salva l’esempio come file HTML e aprilo in un browser. Il risultato compare nella console di sviluppo. `null` indica che l’attributo è assente, non che è vuoto: nella seconda riga è presente e contiene `""`. Non è necessario aggiungere l’elemento alla pagina.

Lezioni correlate

  • JavaScript · Lezione 43 · Intermedio · Versione: 3

Fonti