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
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/disableddel 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-labeldirecto. - Es un
toggleocheckboxsuelto 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
fieldsetalrededor.
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.
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-spinnerdata-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/idyaria-describedby; el control inválido llevaaria-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.