WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

textarea — mehrzeiliges Textfeld

Das Element textarea dient zum Bearbeiten von mehrzeiligem Klartext. Erfahre, worin sich Anfangs- und aktueller Wert unterscheiden, wie das Feld beschriftet wird und welche Rolle es in einem Formular spielt.

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

Syntax

<textarea id="message" name="message" rows="4" cols="40">Initial text</textarea>

textarea ist ein mehrzeiliges Klartext-Eingabefeld, kein HTML-Editor. Es benötigt ein End-Tag. Der Text zwischen den Tags legt den Standardwert fest; ein value-Attribut setzt diesen Standardwert nicht.

In JavaScript liest oder ändert die Eigenschaft value den aktuellen Wert, während defaultValue dem Standardtext entspricht. Beim Zurücksetzen des Formulars wird der Standardwert wiederhergestellt. Das Beispiel zeigt diesen Unterschied ohne Benutzerinteraktion.

Verknüpfe ein label über übereinstimmende Werte für for und id mit dem Feld; placeholder ersetzt kein Label. name bestimmt den Namen des Feldes beim Absenden des Formulars. rows und cols legen die Abmessungen des Feldes fest, nicht die Textlänge.

required verlangt einen nicht leeren Wert in einem bearbeitbaren Feld. readonly verhindert die Bearbeitung, schließt den Wert aber nicht von der Übermittlung aus; disabled verhindert die Interaktion und schließt den Wert von der Übermittlung aus. Beide schließen das Feld von der Einschränkungsvalidierung aus.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Textarea example</title>
<form id="form">
  <label for="message">Message</label>
  <textarea id="message" name="message" rows="3" cols="30" required>Hello</textarea>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('form');
  const message = document.getElementById('message');
  const lines = [];
  lines.push(message.value);
  message.value = 'Updated';
  lines.push(message.value);
  lines.push(message.defaultValue);
  form.reset();
  lines.push(message.value);
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Ergebnis

Hello
Updated
Hello
Hello

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.

Quellen