CKTIS / HTML
wrap — tekstterugloop van textarea bij verzenden
Het wrap-attribuut van textarea bepaalt of de browser regeleinden toevoegt aan de waarde die met een formulier wordt verzonden. Het onderscheidt zichtbare tekstterugloop van daadwerkelijke newline-tekens.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<textarea wrap="soft">…</textarea>
<textarea wrap="hard" cols="20">…</textarea>wrap is een enumeratief attribuut van textarea, geen booleaans attribuut. De trefwoorden zijn soft en hard. Als het attribuut ontbreekt of een ongeldige waarde heeft, wordt de toestand soft gekozen.
Bij soft kan de browser tekst visueel laten doorlopen zonder vanwege die weergave regeleinden aan de verzonden waarde toe te voegen. Door de gebruiker ingevoerde regeleinden blijven deel van de tekst. Bij hard voegt de browser LF-tekens (U+000A) toe aan de verzonden waarde, zodat regels niet langer zijn dan de tekenbreedte die met cols is opgegeven. In deze toestand moet cols als positief geheel getal worden opgegeven.
Het exacte algoritme voor tekstterugloop is afhankelijk van de implementatie: ga er niet van uit dat afbreekpunten in alle browsers hetzelfde zijn. Extra regeleinden die door hard ontstaan, worden niet toegevoegd aan de eigenschap .value; die geeft de API-waarde met regeleinden die naar LF zijn genormaliseerd.
Het voorbeeld wijzigt wrap via de DOM-eigenschap en laat zien dat .value ongewijzigd blijft. Het test niet waar tekst wordt afgebroken in verzonden formuliergegevens.
Voorbeelden
<!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>Resultaat
{"wrap":"hard","unchanged":true,"value":"alpha beta gamma"}De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.