FileUpload
Zona de carga de archivos con drag & drop. Valida tipo y tamaño, lista los cargados y permite eliminarlos.
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.
Adjuntos múltiples con tope de tamaño
Arrastrar archivos aquí o usar el botón
Adjuntos
Hasta 2 MB por archivo
Cuándo usarlo
- El usuario tiene que subir uno o varios archivos (imágenes, documentos).
- Se busca validar tipo y tamaño antes de aceptar.
- Conviene mostrar lo ya cargado y poder quitarlo.
Cuándo no
- Alcanza con un
<input type="file">mínimo, sin lista ni validación. - No es un archivo sino un valor de texto o número → el control que corresponda.
Cómo usarlo
- Se declaran los tipos aceptados y el tamaño máximo, y se explica el límite.
- Se arma con el HTML de
fieldpara el label y los errores de validación.
Cómo no usarlo
- No se acepta cualquier cosa: tipo y tamaño se validan en el cliente y en el server.
- No se ocultan el progreso ni los errores de una carga que falla.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Se monta sobre un <input type="file"> nativo y suma arrastrar y soltar y la lista de archivos.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-file-error-icondata-ts-file-error-sizedata-ts-file-inputdata-ts-file-listdata-ts-file-templatedata-ts-file-triggerdata-ts-file-uploaddata-ts-max-size
Qué hace: Arrastrar y soltar, y pintar la lista de archivos elegidos. Con multiple, cada selección se suma a la lista (sin multiple la reemplaza) y cada fila tiene su botón «Quitar»; como el input nativo no acumula, el Core guarda la lista y rearma input.files sólo con los archivos válidos. La fila sale de un <template data-ts-file-template> del ejemplo. La lista vacía va con hidden.
| Atributo | Qué hace |
|---|---|
data-ts-file-error-size | En la raíz: el error de un archivo más grande que data-ts-max-size, con el máximo ya escrito. Sin él, «Demasiado grande (máx. …)». |
data-ts-file-error-type | En la raíz: el error de un archivo que no entra en el accept del input. Sin él, «Tipo de archivo no permitido». |
Sin build, desde el CDN: taisho.file-upload.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 selector se abre con el botón de la zona (un
<button>real: Tab llega a él y Enter o Espacio lo activan). Arrastrar y soltar es una mejora para el puntero: la zona no es una parada de Tab. - Se apoya en un
<input type="file">real para abrir el selector nativo. - Los archivos con error de validación muestran el motivo junto al nombre.
- Cada archivo de la lista tiene un botón con
aria-label«Quitar <nombre>». Conmultiplela lista acumula las selecciones y la lista vacía no ocupa espacio ni se expone (hidden).
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Enter/Espacio | Sobre el botón «Seleccionar archivos», abre el selector de archivos. |
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 Mapa de teclas documentado arriba, contrastado contra el componente.
- 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.