Saltar al contenido

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

html

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 field para 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.

Relacionados

FieldButton

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-icon
  • data-ts-file-error-size
  • data-ts-file-input
  • data-ts-file-list
  • data-ts-file-template
  • data-ts-file-trigger
  • data-ts-file-upload
  • data-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-sizeEn 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-typeEn 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.css
  • taisho.icon.css
  • taisho.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>». Con multiple la 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/EspacioSobre 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.