CKTIS / JavaScript
Normalisierung von Zeilenenden in HTMLTextAreaElement.value
Beim Lesen von `HTMLTextAreaElement.value` erhältst du Text mit LF-Zeilenenden, auch wenn die zugewiesene Zeichenfolge CRLF-Paare oder einzelne CR-Zeichen enthielt.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
textarea.value = text;
const normalized = textarea.value;Die Eigenschaft value einer HTMLTextAreaElement-Instanz dient zum Schreiben und Lesen des aktuellen Texts. Eine Zuweisung setzt den Rohwert des Steuerelements; beim Lesen erhältst du den normalisierten API-Wert. Jedes CRLF-Paar (\r\n) und jedes einzeln stehende CR (\r) wird zu genau einem LF (\n). Vorhandene LF-Zeichen bleiben unverändert.
Das ist eine Regel des HTML-DOM und keine allgemeine Regel für ECMAScript-Zeichenfolgen. Die Zuweisung verändert die ursprüngliche Zeichenfolge nicht. Beim Lesen von value lässt sich aber nicht mehr erkennen, welche LF-Zeichen zuvor CRLF-Paare oder einzelne CR waren. Bewahre das Original separat auf, wenn diese Unterschiede wichtig sind. defaultValue spiegelt den Standardtext des Elements wider, nicht den aktuell bearbeiteten Text.
Ein rein visueller Zeilenumbruch fügt value keine Zeichen hinzu. Beim Absenden eines Formulars kann wrap="hard" bei gesetztem cols dem übermittelten Wert Zeilenumbrüche hinzufügen. Die Kodierung multipart/form-data serialisiert Zeilenenden im Wert eines Textfelds als CRLF. Das ändert nicht, was beim Lesen von value zurückgegeben wird.
Beispiele
<!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>Ergebnis
"A\r\nB\rC\nD" "A\nB\nC\nD"
Speichere das Beispiel als `.html`-Datei, öffne sie im Browser und prüfe die Ausgabe in der Browserkonsole. `JSON.stringify` macht Zeilenenden als Escape-Sequenzen sichtbar: Die erste Zeile zeigt die ursprüngliche Zeichenfolge, die zweite das Ergebnis beim Lesen von `value`. Das Element muss nicht in das Dokument eingefügt werden.
Zugehörige Lektionen
- JavaScript · Lektion 9 · Fortgeschritten · Version: 4