Saltar al contenido

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

html

Correo con ayuda

html

Con error

html

Con ícono al inicio

html

Con prefijo de texto

https://
html

Limpiable

html

Cargando

html

Búsqueda 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 del campo: sm, md o lg.

html

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.

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 muestra el Spinner sin bloquear nada.

html

Combinaciones

Tamaño, variante y densidad actuando juntos.

html

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 type se 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 field para el label y los mensajes.
  • Se elige el type correcto: 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.

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-clear
  • data-ts-debounce
  • data-ts-field-spinner
  • data-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-spinnerEl 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-clearBotó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.css
  • taisho.icon.css
  • taisho.kbd.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • El label se asocia al input 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 campo por aria-describedby; un campo inválido lleva aria-invalid="true".
  • El botón de limpiar (data-ts-clear) tiene aria-label propio, escrito en el HTML.
  • La clase is-readonly del contenedor (junto con readonly en el <input>) deja el fondo transparente y el cursor default, sin la escalada visual de hover: el campo sigue siendo enfocable y seleccionable, distinguible tanto de uno editable como de uno disabled. El botón de limpiar está siempre en el HTML con hidden según haya contenido; lo alterna data-ts-clear, y al limpiar el foco vuelve al campo.
  • is-loading NO deshabilita el campo (a diferencia del botón): el <input> sigue editable. setInputLoading(root, true|false) pone is-loading y aria-busy="true" mientras dura la carga; con sólo la clase no se anuncia. El anuncio lo hace el propio Spinner (role="status" con su aria-label) — no se duplica con otro texto vivo. El Spinner convive con «Limpiar campo» en ts 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 evento ts:debouncedinput espera a que la persona deje de escribir: pensado para disparar is-loading y aria-busy recién entonces, sin acosar al lector de pantalla con un «Cargando» por cada tecla. El evento input sigue 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.