Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti