Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

textarea — wielowierszowe pole tekstowe

Element textarea służy do edycji wielowierszowego zwykłego tekstu. Poznaj wartość początkową i bieżącą, etykietę oraz udział pola w formularzu.

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

Składnia

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

textarea jest polem edycji wielowierszowego zwykłego tekstu, nie edytorem HTML. Wymaga znacznika końcowego. Tekst między znacznikami określa wartość domyślną; nie ustawia się jej atrybutem value.

W JavaScript właściwość value odczytuje lub zmienia bieżącą wartość, a defaultValue odpowiada tekstowi domyślnemu. Reset formularza przywraca wartość domyślną. Przykład pokazuje tę różnicę bez interakcji użytkownika.

Powiąż label z polem przez zgodne for i id; placeholder nie zastępuje etykiety. name określa nazwę pola przy wysyłaniu formularza. rows i cols określają wymiary pola, nie limit tekstu.

required wymaga niepustej wartości edytowalnego pola. readonly blokuje edycję, ale nie wyklucza wartości z wysyłania; disabled blokuje interakcję i wyklucza wartość z wysyłania. Oba wyłączają pole z walidacji ograniczeń.

Przykłady

<!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>

Wynik

Hello
Updated
Hello
Hello

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła