CKTIS / JavaScript
HTMLInputElement.value — lire et définir la valeur d’un champ
HTMLInputElement.value permet de lire ou de définir une valeur sous forme de chaîne. Son comportement dépend de type ; pour un champ texte, la valeur actuelle peut différer de la valeur par défaut.
Version : 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 est une propriété de l’API Web, et non d’ECMAScript lui-même. Elle renvoie une chaîne, même pour type="number" ; utilisez valueAsNumber pour lire un nombre. Elle nécessite un environnement DOM de navigateur, et Node.js seul ne suffit pas.
Pour un champ texte, .value désigne la valeur actuelle. defaultValue reflète l’attribut HTML value. Affecter une valeur à .value active un indicateur interne de modification : les changements ultérieurs de l’attribut ne mettent alors plus à jour la valeur actuelle jusqu’à la réinitialisation de cet indicateur, par exemple lors de la réinitialisation du formulaire. L’affectation ne déclenche pas automatiquement les événements input ou change.
Le navigateur applique des règles d’assainissement propres à chaque type : une valeur numérique invalide peut devenir "". Pour les cases à cocher et les boutons radio, .value indique la valeur envoyée, "on" par défaut, et non si le contrôle est sélectionné — utilisez checked pour connaître cet état.
Pour type="file", utilisez files pour accéder aux fichiers. .value ne révèle pas le chemin réel ; affecter une chaîne non vide déclenche InvalidStateError, tandis que "" efface la sélection.
Exemples
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")
}));Résultat
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.