CKTIS / JavaScript
HTMLInputElement.value — de waarde van een invoerveld lezen en instellen
Met HTMLInputElement.value lees of stel je een waarde in als tekenreeks. Het gedrag hangt af van type; bij een tekstveld kan de huidige waarde verschillen van de standaardwaarde.
Versie: 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 is een eigenschap van de Web API, niet van ECMAScript zelf. De eigenschap retourneert een tekenreeks, ook bij type="number"; gebruik valueAsNumber om een getal te lezen. Er is een browseromgeving met DOM nodig; alleen Node.js volstaat niet.
Bij een tekstveld staat .value voor de huidige waarde. defaultValue weerspiegelt het HTML-attribuut value. Door een waarde aan .value toe te wijzen, wordt intern een gewijzigde-waardevlag ingesteld: latere wijzigingen aan het attribuut werken de huidige waarde dan niet meer bij totdat die vlag wordt gereset, bijvoorbeeld door het formulier te resetten. De toewijzing activeert niet automatisch de gebeurtenissen input of change.
De browser past opschoningsregels toe die afhangen van type: een ongeldige numerieke waarde kan "" worden. Bij selectievakjes en keuzerondjes geeft .value de verzonden waarde aan, standaard "on", niet of het element is geselecteerd — lees daarvoor checked.
Gebruik voor type="file" de eigenschap files om bestanden te openen. .value onthult het echte pad niet; een niet-lege tekenreeks toewijzen veroorzaakt InvalidStateError, terwijl "" de selectie wist.
Voorbeelden
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")
}));Resultaat
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.