Saltar al contenido

Field

Primitiva de formularios: ata el label, la ayuda y el error a su control — id compartido con el label, aria-describedby al mensaje, aria-invalid y los estados required/disabled. En HTML son el ts input-label, el control y el ts input-hint, uno junto al otro; el label, la ayuda y el error se escriben una sola vez, ahí.

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 obligatorio con ayuda

html

Cuándo usarlo

  • Casi siempre que se agrega un control: es lo que ata label, hint y error al control.
  • Hace falta mostrar un error o una ayuda ligada al campo y anunciada por el lector.
  • Se busca un solo lugar que maneje required/disabled del conjunto label+control.

Cuándo no

  • El control se explica solo y no lleva label visible (un botón de ícono) → conviene darle un aria-label directo.
  • Es un toggle o checkbox suelto con su etiqueta al lado, no un campo con label arriba.

Cómo usarlo

  • El label es el real, no un placeholder: el placeholder se va al escribir.
  • Un Field por control; para agrupar varios, se usa un fieldset alrededor.

Cómo no usarlo

  • El label y la ayuda no se repiten en el control: van una sola vez, atados a él.
  • No se usa para maquetar: es cableado de accesibilidad, no un layout.

Relacionados

InputSelectTextarea

TaishoDS Core

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

Es un envoltorio de etiqueta, ayuda y error. El control de adentro (Input, Textarea) trae su propio comportamiento.

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

  • data-ts-field-spinner
  • data-ts-input

Qué hace: Nada propio. El <input> del ejemplo lleva los atributos de Input (data-ts-input, data-ts-field-spinner) para el estado de carga y el debounce; los resuelve el Core de Input, no el de Field.

Sin build, desde el CDN: este componente no tiene archivo propio, se arma con taisho.base.cssy con los de abajo. También se carga:

  • taisho.icon.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • La etiqueta, la ayuda y el error se enlazan al control por for/id y aria-describedby; el control inválido lleva aria-invalid="true".

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.