CKTIS / HTML
wrap — Textumbruch in textarea beim Absenden
Das wrap-Attribut von textarea legt fest, ob der Browser dem mit einem Formular übermittelten Wert Zeilenumbrüche hinzufügt. Es unterscheidet den sichtbaren Zeilenumbruch von tatsächlichen Zeilenumbruchzeichen.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>wrap ist ein enumeriertes Attribut von textarea, kein boolesches Attribut. Die Schlüsselwörter sind soft und hard. Fehlt das Attribut oder ist sein Wert ungültig, wird der Zustand soft gewählt.
Bei soft kann der Browser den Text optisch umbrechen, ohne aufgrund dieses Umbruchs Zeilenumbrüche für die Übermittlung hinzuzufügen. Vom Benutzer eingegebene Zeilenumbrüche bleiben Teil des Textes. Bei hard fügt der Browser LF-Zeichen (U+000A) in den übermittelten Wert ein, damit die Zeilen die durch cols angegebene Zeichenbreite nicht überschreiten. In diesem Zustand muss cols als positive Ganzzahl angegeben werden.
Der genaue Umbruchalgorithmus ist implementationsabhängig: Gehe nicht davon aus, dass die Umbruchstellen in allen Browsern identisch sind. Zusätzliche, durch hard erzeugte Umbrüche werden nicht in die .value-Eigenschaft eingefügt. Diese stellt den API-Wert mit auf LF normalisierten Zeilenumbrüchen bereit.
Das Beispiel ändert wrap über seine DOM-Eigenschaft und zeigt, dass .value unverändert bleibt. Es prüft nicht die Umbruchstellen in übermittelten Formulardaten.
Beispiele
<!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>Ergebnis
{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.