Input
Campo de texto de una línea. Soporta label, ayuda, error, prefijos y sufijos, contador de caracteres y botón de limpieza (data-ts-clear).
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.
Campo con etiqueta y placeholder
Correo con ayuda
Con error
Con ícono al inicio
Con prefijo de texto
Limpiable
Cargando
Búsqueda 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 del campo: sm, md o lg.
Variante
El color del borde según validación: default, success, warning, info o danger. variant-bare (no se muestra aquí) saca la caja y el foco, para un campo dentro de otro componente.
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 muestra el Spinner sin bloquear nada.
Combinaciones
Tamaño, variante y densidad actuando juntos.
Cuándo usarlo
- Capturar texto corto en una línea: nombre, email, búsqueda, un código.
- Hace falta un prefijo/sufijo (una unidad, un ícono) o un botón de limpieza.
- Con
typese pasa a email/password/tel y se aprovecha el teclado del sistema.
Cuándo no
- El texto puede ser largo o multilínea →
textarea. - Es un número con tope y paso →
number-input. - Es una fecha →
date-picker.
Cómo usarlo
- Se arma con el HTML de
fieldpara el label y los mensajes. - Se elige el
typecorrecto: mejora el teclado móvil y la validación.
Cómo no usarlo
- El placeholder no se usa como label.
- No se usa para elegir de un conjunto cerrado →
select.
Relacionados
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Es un <input> 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-input
Qué hace: Mantiene el campo al día: el cursor de cada campo con valor queda al final al iniciar, así element.focus() desde código no escribe antes del texto. Con Tab (que selecciona todo) y con clic no cambia nada.
| Atributo | Qué hace |
|---|---|
data-ts-field-spinner | El Spinner que el ejemplo deja oculto. setInputLoading(root, true | false) marca el campo como ocupado (aria-busy) y lo muestra; no bloquea la edición. |
data-ts-debounce="ms" | En el <input>: el Core emite ts:debouncedinput (con detail.value) cuando la persona deja de escribir; limpiar avisa el vacío enseguida. |
data-ts-clear | Botón que se muestra sólo si hay contenido y, al clic, limpia el campo, dispara input y change y devuelve el foco. |
Sin build, desde el CDN: taisho.input.css, además de taisho.base.css. También se carga:
taisho.button.csstaisho.icon.csstaisho.kbd.csstaisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- El
labelse asocia al input 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 campo poraria-describedby; un campo inválido llevaaria-invalid="true". - El botón de limpiar (
data-ts-clear) tienearia-labelpropio, escrito en el HTML. - La clase
is-readonlydel contenedor (junto conreadonlyen el<input>) deja el fondo transparente y el cursordefault, sin la escalada visual de hover: el campo sigue siendo enfocable y seleccionable, distinguible tanto de uno editable como de unodisabled. El botón de limpiar está siempre en el HTML conhiddensegún haya contenido; lo alternadata-ts-clear, y al limpiar el foco vuelve al campo. is-loadingNO deshabilita el campo (a diferencia del botón): el<input>sigue editable.setInputLoading(root, true|false)poneis-loadingyaria-busy="true"mientras dura la carga; con sólo la clase no se anuncia. El anuncio lo hace el propio Spinner (role="status"con suaria-label) — no se duplica con otro texto vivo. El Spinner convive con «Limpiar campo» ents input-actions.- Con
element.focus()desde código (p. ej. al abrir un formulario) el cursor queda al final del valor, así que lo que se escribe continúa el texto en vez de insertarse antes. Con Tab el navegador selecciona todo el contenido. - Con
data-ts-debounce, el eventots:debouncedinputespera a que la persona deje de escribir: pensado para dispararis-loadingyaria-busyrecién entonces, sin acosar al lector de pantalla con un «Cargando» por cada tecla. El eventoinputsigue inmediato.
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.