CKTIS / JavaScript
HTMLInputElement.value — čtení a nastavení hodnoty vstupního pole
HTMLInputElement.value umožňuje číst hodnotu jako řetězec nebo ji nastavit. Chování závisí na type; u textového pole se aktuální hodnota může lišit od výchozí.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.value
input.value = "new value";HTMLInputElement.value je vlastnost Web API, nikoli samotného ECMAScriptu. Vrací řetězec, i když je nastaveno type="number"; číslo přečtete pomocí valueAsNumber. Vyžaduje prostředí prohlížeče s DOM, samotný Node.js nestačí.
U textového pole označuje .value aktuální hodnotu. defaultValue odráží atribut HTML value. Přiřazení hodnoty do .value nastaví interní příznak změněné hodnoty: následné změny atributu už aktuální hodnotu neaktualizují, dokud se příznak nevynuluje, například resetováním formuláře. Přiřazení automaticky nevyvolá události input ani change.
Prohlížeč používá pravidla čištění závislá na type: neplatná číselná hodnota se může změnit na "". U zaškrtávacích polí a přepínačů určuje .value odesílanou hodnotu, která je ve výchozím nastavení "on", nikoli to, zda je ovládací prvek vybraný — to zjistíte pomocí checked.
Pro type="file" použijte k přístupu k souborům files. .value neodhaluje skutečnou cestu; přiřazení neprázdného řetězce vyvolá InvalidStateError, zatímco "" výběr vymaže.
Příklady
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")
}));Výsledek
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.