CKTIS / JavaScript
HTMLInputElement.value — branje in nastavljanje vrednosti vnosnega polja
HTMLInputElement.value omogoča branje vrednosti kot niza ali njeno nastavitev. Obnašanje je odvisno od type; pri besedilnem polju se lahko trenutna vrednost razlikuje od privzete.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
input.value
input.value = "new value";HTMLInputElement.value je lastnost spletnega API-ja, ne samega ECMAScripta. Vrne niz, tudi pri type="number"; za branje števila uporabite valueAsNumber. Potrebujete okolje brskalnika z DOM-om, sam Node.js ne zadostuje.
Pri besedilnem polju .value pomeni trenutno vrednost. defaultValue odraža atribut HTML value. Z dodelitvijo vrednosti lastnosti .value se nastavi notranja oznaka spremenjene vrednosti: poznejše spremembe atributa trenutne vrednosti ne posodabljajo več, dokler oznaka ni ponastavljena, na primer s ponastavitvijo obrazca. Dodelitev samodejno ne sproži dogodkov input ali change.
Brskalnik uporablja pravila čiščenja, odvisna od type: neveljavna številska vrednost lahko postane "". Pri potrditvenih poljih in izbirnih gumbih .value določa poslano vrednost, privzeto "on", ne pa tega, ali je kontrolnik izbran — za to preberite checked.
Za type="file" uporabite files za dostop do datotek. .value ne razkrije dejanske poti; dodelitev nepraznega niza sproži InvalidStateError, medtem ko "" počisti izbor.
Primeri
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")
}));Rezultat
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.