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
Limpiable
Cargando
Redimensionable en ambos ejes
Comentario que espera a que termine la escritura
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.
Variante
El color del borde según validación: success, warning, info o danger.
Densidad
El aire interno del campo.
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.
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.
Combinaciones
Tamaño, variante y densidad actuando juntos.
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
fieldy, 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.
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-cleardata-ts-debouncedata-ts-field-spinnerdata-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-clear | Botón de limpiar, igual que en Input. |
data-ts-field-spinner | El 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-both | El 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.csstaisho.icon.csstaisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- El
labelse asocia porfor/id; elidse 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>poraria-describedby; un campo inválido llevaaria-invalid="true". readonlyagregais-readonlyal wrapper (fondo transparente, cursordefault): el campo sigue siendo enfocable y seleccionable, distinguible de uno editable y de unodisabled.- El botón de limpiar (
data-ts-clear) tienearia-labelpropio, 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): poneis-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 eventots:debouncedinputespera a que se deje de escribir (300 ms por defecto), para no disparararia-busyen cada tecla; el eventoinputsigue inmediato y limpiar avisa el vacío ya. resize-none,resize-horizontalyresize-bothsólo cambian el tirador de la esquina: no alteran el rol ni el nombre. Conauto-resizeel 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.