База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

wrap — пренасяне на textarea при изпращане

Атрибутът wrap на textarea определя дали браузърът добавя нови редове към стойността, изпратена с формуляр. Той разграничава видимото пренасяне на текста от действителните символи за нов ред.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

wrap е изброен атрибут на textarea, а не булев атрибут. Ключовите му думи са soft и hard. Ако атрибутът липсва или стойността му е невалидна, се избира състоянието soft.

При soft браузърът може визуално да пренася текста, без заради това пренасяне да добавя нови редове към изпращаната стойност. Новите редове, въведени от потребителя, остават част от текста. При hard браузърът вмъква знаци LF (U+000A) в изпращаната стойност, така че редовете да не надвишават ширината в знаци, зададена чрез cols. В това състояние cols трябва да бъде зададен като положително цяло число.

Точният алгоритъм за пренасяне зависи от реализацията: не приемайте, че местата на пренасяне са еднакви във всички браузъри. Допълнителните нови редове, създадени от hard, не се вмъкват в свойството .value, което предоставя стойността на API с нормализирани до LF нови редове.

Примерът променя wrap чрез DOM свойството му и показва, че .value остава непроменено. Той не проверява местата на пренасяне в изпратените данни на формуляра.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници