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

CKTIS / HTML

wrap — retour à la ligne de textarea lors de l’envoi

L’attribut wrap de textarea détermine si le navigateur ajoute des sauts de ligne à la valeur envoyée avec un formulaire. Il distingue le retour à la ligne visible des véritables caractères de nouvelle ligne.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>

wrap est un attribut énuméré de textarea, et non un attribut booléen. Ses mots-clés sont soft et hard. Si l’attribut est absent ou si sa valeur est invalide, l’état soft est sélectionné.

Avec soft, le navigateur peut afficher le texte sur plusieurs lignes sans ajouter de sauts de ligne à la valeur envoyée en raison de cet affichage. Les sauts de ligne saisis par l’utilisateur restent dans le texte. Avec hard, le navigateur insère des caractères LF (U+000A) dans la valeur envoyée afin que les lignes ne dépassent pas la largeur en caractères indiquée par cols. Dans cet état, cols doit être une valeur entière positive.

L’algorithme exact de retour à la ligne dépend de l’implémentation : ne supposez pas que les points de coupure sont identiques dans tous les navigateurs. Les sauts supplémentaires produits par hard ne sont pas insérés dans la propriété .value, qui expose la valeur de l’API avec les sauts de ligne normalisés en LF.

L’exemple modifie wrap via sa propriété DOM et montre que .value reste inchangée. Il ne teste pas les points de coupure dans les données de formulaire envoyées.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>wrap</title>
<label for="note">Text</label>
<textarea id="note" wrap="soft" cols="5">alpha beta gamma</textarea>
<pre id="result"></pre>
<script>
  const note = document.getElementById("note");
  const result = document.getElementById("result");
  const before = note.value;
  note.wrap = "hard";
  result.textContent = JSON.stringify({
    wrap: note.wrap,
    unchanged: note.value === before,
    value: note.value
  });
</script>

Résultat

{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}

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