Saltar al contenido

Textarea

Campo de texto multilínea. Comparte label, hint, error y variantes con Input, y agrega auto-crecimiento de altura.

Formularios · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Comentario con placeholder

html

Limpiable

html

Cargando

html

Redimensionable en ambos ejes

html

Comentario que espera a que termine la escritura

html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Tamaño

El alto base del área: sm, md o lg.

html

Variante

El color del borde según validación: success, warning, info o danger.

html

Densidad

El aire interno del campo.

html

Estados

is-disabled bloquea la edición; is-readonly la impide pero mantiene el campo enfocable y seleccionable; is-loading suma el Spinner sin bloquear la edición.

html

Redimensionado

El tirador de la esquina: resize-none lo quita, resize-horizontal y resize-both lo habilitan en ese eje; vertical (sin clase) es el de siempre.

html

Combinaciones

Tamaño, variante y densidad actuando juntos.

html

Cuándo usarlo

  • El texto esperado ocupa varias líneas: un comentario, una descripción, una nota.
  • Se busca que el campo crezca con el contenido (auto-resize).
  • El usuario necesita ver de una todo lo que ya escribió.

Cuándo no

  • El texto es corto y de una línea → input.
  • Es un valor de un conjunto cerrado → select.

Cómo usarlo

  • Conviene darle unas filas iniciales acordes a lo que se espera.
  • Se arma con el HTML de field y, si hay límite, se muestra el contador.

Cómo no usarlo

  • No se usa para una sola línea sólo porque se ve más grande.
  • El límite de caracteres no se esconde si lo hay.

Relacionados

InputField

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

Es un <textarea> nativo, más el botón de limpiar, que es propio.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-clear
  • data-ts-debounce
  • data-ts-field-spinner
  • data-ts-textarea

Qué hace: Cursor al final del valor inicial, igual que Input. Para que el alto crezca al escribir, se escucha input y se copia scrollHeight a la altura; sin eso el textarea funciona igual, con altura fija.

Atributo Qué hace
data-ts-clearBotón de limpiar, igual que en Input.
data-ts-field-spinnerEl Spinner de carga. setTextareaLoading(root, true | false) marca el campo como ocupado y lo muestra; no bloquea la edición.
data-ts-debounce="ms"En el <textarea>: el Core emite ts:debouncedinput (con detail.value) cuando se deja de escribir.
resize-none, resize-horizontal, resize-bothEl resize se elige con una clase del contenedor.

Sin build, desde el CDN: taisho.textarea.css, además de taisho.base.css. También se carga:

  • taisho.button.css
  • taisho.icon.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • El label se asocia por for/id; el id se escribe en el HTML y tiene que ser único en la página.
  • El texto de ayuda (ts input-hint) y el mensaje de error se enlazan al <textarea> por aria-describedby; un campo inválido lleva aria-invalid="true".
  • readonly agrega is-readonly al wrapper (fondo transparente, cursor default): el campo sigue siendo enfocable y seleccionable, distinguible de uno editable y de uno disabled.
  • El botón de limpiar (data-ts-clear) tiene aria-label propio, aparece sólo con texto y no en readonly ni disabled; al limpiar, el foco vuelve al <textarea>. Vive arriba a la derecha, con espacio reservado, sin tapar el texto ni el tirador de resize.
  • Para el estado de carga, se llama a setTextareaLoading(root, true|false): pone is-loading, aria-busy="true" en el <textarea> y el Spinner (role="status") arriba a la derecha, junto al botón de limpiar. Si se pone sólo la clase, cambia el aspecto pero no se anuncia. No deshabilita ni bloquea la edición: se puede seguir escribiendo mientras valida.
  • Con data-ts-debounce, el evento ts:debouncedinput espera a que se deje de escribir (300 ms por defecto), para no disparar aria-busy en cada tecla; el evento input sigue inmediato y limpiar avisa el vacío ya.
  • resize-none, resize-horizontal y resize-both sólo cambian el tirador de la esquina: no alteran el rol ni el nombre. Con auto-resize el eje vertical se apaga, porque la altura la manda el contenido.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.