CKTIS / JavaScript
HTMLInputElement.value — leggere e impostare il valore di un campo
HTMLInputElement.value legge o imposta un valore come stringa. Il comportamento dipende da type; in un campo di testo, il valore attuale può essere diverso da quello predefinito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
input.value
input.value = "new value";HTMLInputElement.value è una proprietà delle Web API, non di ECMAScript in sé. Restituisce una stringa, anche con type="number"; per leggere un numero, usa valueAsNumber. Richiede un ambiente DOM del browser: Node.js da solo non è sufficiente.
Per un campo di testo, .value indica il valore attuale. defaultValue rispecchia l’attributo HTML value. Assegnare un valore a .value attiva un indicatore interno di modifica del valore: le successive modifiche all’attributo non aggiornano più il valore attuale finché l’indicatore non viene reimpostato, per esempio resettando il modulo. L’assegnazione non attiva automaticamente gli eventi input o change.
Il browser applica regole di sanitizzazione specifiche per type: un valore numerico non valido può diventare "". Per le caselle di controllo e i pulsanti di opzione, .value specifica il valore inviato, che per impostazione predefinita è "on", non se il controllo è selezionato; per verificarlo, leggi checked.
Per type="file", usa files per accedere ai file. .value non rivela il percorso reale; assegnare una stringa non vuota genera InvalidStateError, mentre "" cancella la selezione.
Esempi
const input = document.createElement("input");
input.type = "text";
input.defaultValue = "Ada";
input.value = "Lin";
console.log(JSON.stringify({
value: input.value,
defaultValue: input.defaultValue,
attribute: input.getAttribute("value")
}));Risultato
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.