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 = newValueHTMLOptionElement.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