CKTIS / JavaScript
HTMLInputElement.value — odczyt i zapis wartości pola
Właściwość HTMLInputElement.value odczytuje lub ustawia wartość jako tekst. Jej zachowanie zależy od type; w polu tekstowym bieżąca wartość może różnić się od wartości domyślnej.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
input.value
input.value = "new value";HTMLInputElement.value to właściwość Web API, nie samego ECMAScript. Zwraca ciąg znaków, również dla type="number"; do odczytu liczby służy valueAsNumber. Wymaga środowiska z DOM przeglądarki, a nie samego Node.js.
Dla pola tekstowego .value oznacza bieżącą wartość. defaultValue odzwierciedla atrybut HTML value. Przypisanie do .value ustawia wewnętrzną flagę zmiany wartości: późniejsze zmiany atrybutu nie aktualizują już bieżącej wartości aż do zresetowania tej flagi, np. przez reset formularza. Przypisanie nie wywołuje automatycznie zdarzeń input ani change.
Przeglądarka stosuje reguły oczyszczania zależne od type: niepoprawna wartość liczbowa może stać się "". Dla checkboxów i przycisków radiowych .value określa przesyłaną wartość, domyślnie "on", a nie stan zaznaczenia — ten odczytuje checked.
Dla type="file" korzystaj z files, aby odczytać pliki. .value nie ujawnia rzeczywistej ścieżki; przypisanie niepustego tekstu zgłasza InvalidStateError, a "" czyści wybór.
Przykłady
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")
}));Wynik
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.