Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLTextAreaElement.value — texte actuel du champ

`HTMLTextAreaElement.value` permet de lire ou de définir le texte actuel d’un élément `textarea`. Une affectation à `value` ne change pas `defaultValue`, mais modifier `defaultValue` peut changer le texte renvoyé par `value` tant que l’indicateur interne de valeur modifiée n’est pas activé.

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

textarea.value
textarea.value = text

HTMLTextAreaElement.value est une propriété de l’API Web de type chaîne, et ne fait pas partie d’ECMAScript lui-même. Elle lit le texte actuel de textarea ; une affectation remplace ce texte. La lecture normalise les fins de ligne en LF (\n).

defaultValue représente le texte par défaut. Affecter une valeur à value ne le modifie pas et définit l’indicateur interne de valeur modifiée. La réinitialisation du formulaire rétablit le texte par défaut.

Affecter une valeur à value ne déclenche pas à lui seul l’événement input. L’exemple nécessite un DOM de navigateur ; la seule présence de Node 24 ne permet pas d’établir que cette API est prise en charge.

Exemples

const textarea = document.createElement('textarea');
textarea.defaultValue = 'Start';
textarea.value = 'A\r\nB';
console.log(JSON.stringify(textarea.value));
console.log(textarea.defaultValue);

Résultat

"A\nB"
Start

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.

Sources