Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

wrap — ajuste de línea de textarea al enviar

El atributo wrap de textarea determina si el navegador añade saltos de línea al valor enviado con un formulario. Distingue el ajuste de línea visible de los caracteres de nueva línea reales.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

wrap es un atributo enumerado de textarea, no un atributo booleano. Sus palabras clave son soft y hard. Si se omite el atributo o su valor no es válido, se selecciona el estado soft.

Con soft, el navegador puede ajustar visualmente el texto sin añadir al valor enviado saltos de línea debidos a ese ajuste. Los saltos de línea introducidos por el usuario siguen formando parte del texto. Con hard, el navegador inserta caracteres LF (U+000A) en el valor enviado para que las líneas no superen el ancho en caracteres especificado por cols. En este estado, hay que proporcionar cols como un entero positivo.

El algoritmo exacto de ajuste depende de la implementación: no des por hecho que los puntos de salto son idénticos en todos los navegadores. Los saltos adicionales producidos por hard no se insertan en la propiedad .value, que expone el valor de la API con los saltos de línea normalizados a LF.

El ejemplo cambia wrap mediante su propiedad DOM y muestra que .value no cambia. No comprueba los puntos de ajuste en los datos del formulario enviado.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes