Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje