CKTIS / JavaScript
HTMLInputElement.value — čítanie a nastavenie hodnoty vstupného poľa
HTMLInputElement.value umožňuje čítať hodnotu ako reťazec alebo ju nastaviť. Správanie závisí od type; v textovom poli sa aktuálna hodnota môže líšiť od predvolenej.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
input.value
input.value = "new value";HTMLInputElement.value je vlastnosť Web API, nie samotného ECMAScriptu. Vráti reťazec aj pri type="number"; číslo prečítate pomocou valueAsNumber. Vyžaduje prostredie prehliadača s DOM, samotný Node.js nestačí.
V textovom poli označuje .value aktuálnu hodnotu. defaultValue odráža atribút HTML value. Priradením hodnoty do .value sa nastaví interný príznak zmenenej hodnoty: následné zmeny atribútu už aktuálnu hodnotu neaktualizujú, kým sa príznak nevynuluje, napríklad resetovaním formulára. Priradenie automaticky nevyvolá udalosti input ani change.
Prehliadač používa pravidlá čistenia závislé od type: neplatná číselná hodnota sa môže zmeniť na "". Pri zaškrtávacích políčkach a prepínačoch určuje .value odosielanú hodnotu, ktorá je predvolene "on", nie to, či je ovládací prvok vybratý — to zistíte pomocou checked.
Pre type="file" použite na prístup k súborom files. .value neodhaľuje skutočnú cestu; priradenie neprázdneho reťazca vyvolá InvalidStateError, zatiaľ čo "" výber vymaže.
Prí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ýsledok
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.