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

CKTIS / JavaScript

Normalisation des fins de ligne dans HTMLTextAreaElement.value

La lecture de `HTMLTextAreaElement.value` renvoie du texte dont les fins de ligne sont des LF, même si la chaîne affectée contenait des paires CRLF ou des CR isolés.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

textarea.value = text;
const normalized = textarea.value;

La propriété value d’une instance de HTMLTextAreaElement permet de lire et de modifier le texte courant. L’affectation définit la valeur brute du contrôle ; la lecture renvoie la valeur normalisée de l’API. Chaque paire CRLF (\r\n) et chaque CR isolé (\r) deviennent un seul LF (\n). Les LF déjà présents restent inchangés.

C’est une règle du DOM HTML, pas une règle générale des chaînes ECMAScript. L’affectation ne modifie pas la chaîne d’origine, mais la lecture de value ne permet plus de savoir quels LF étaient des paires CRLF ou des CR isolés. Conserve l’original séparément si ces différences comptent. defaultValue reflète le texte par défaut de l’élément, et non le texte courant après modification.

Le retour à la ligne visuel n’ajoute aucun caractère à value. Lors de l’envoi d’un formulaire, wrap="hard", si cols est défini, peut ajouter des sauts de ligne à la valeur envoyée. L’encodage multipart/form-data sérialise les fins de ligne de la valeur d’un champ texte en CRLF, sans modifier ce que renvoie la lecture de value.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Textarea newline normalization</title>
<script>
  const textarea = document.createElement("textarea");
  const original = "A\r\nB\rC\nD";
  textarea.value = original;
  console.log(JSON.stringify(original));
  console.log(JSON.stringify(textarea.value));
</script>

Résultat

"A\r\nB\rC\nD"
"A\nB\nC\nD"

Enregistre l’exemple dans un fichier `.html`, ouvre-le dans un navigateur et consulte la sortie dans la console du navigateur. `JSON.stringify` rend les fins de ligne visibles sous forme de séquences d’échappement : la première ligne montre la chaîne d’origine et la seconde le résultat de la lecture de `value`. Il n’est pas nécessaire d’insérer l’élément dans le document.

Leçons associées

  • JavaScript · Leçon 9 · Avancé · Version : 4

Sources