Módulo general para manerjar el control de adjuntar en los formularios normales y en las grids Fw7.
jQuery es una dependencia para este script
Members
Objeto global que almacena la definición de cada control adjuntar
Methods
#
(inner) _addFileEvtGrid(idGrid)
Tiene la lógica para cargar los adjuntos en cada fila de la grid al abrir el modal
Parameters:
Name |
Type |
Description |
idGrid |
string
|
id de la grid |
#
(inner) _loadGridFiles(idGrid, idxRow)
Cargar los adjuntos de la grid cuando se abre el modal de una fila con adjuntos
Parameters:
Name |
Type |
Description |
idGrid |
string
|
id de la grid |
idxRow |
integer
|
indice de la fila de la grid |
#
(inner) _previewAdjunto(li)
Previsualiza el adjunto en un modal
Parameters:
Name |
Type |
Description |
li |
HTMLLIElement
|
control li que se desea previsualizar |
#
(inner) addEvtPreview()
Asigna el evento de previsualización a los files
#
(inner) addEvtRemove()
Asigna el evento para remover los archivos
#
(inner) addFileGrid(idFile)
Función para agregar un adjunto en la grid
Parameters:
Name |
Type |
Description |
idFile |
string
|
id que se asigna en el control HTML ol |
Carga en el control adjuntar los archivos subidos, se invoca luego de cerrar el modal
Si el archivo ya existe, lo valida, dispara eventos cuando existe y cuando agrega los archivos
Parameters:
Name |
Type |
Description |
dataFile |
string
|
Objeto de la grid ya inicializada |
idFile |
string
|
id que se asigna en el control HTML ol |
#
(inner) addNewLiFile(idFile, url, name, remove)
Agrega un nuevo nodo li sobre el control adjuntar
Parameters:
Name |
Type |
Description |
idFile |
string
|
id que se asigna en el control HTML ol |
url |
string
|
ruta del archivo adjunto |
name |
string
|
nombre del archivo |
remove |
boolean
|
true para que aparezca el botón para eliminar, false para que no aparezca |
#
(inner) adjuntarFile(idFile, type, kb, numFiles)
Carga la configuración y abre el modal para adjuntar, esta función se invoca automáticamente
Parameters:
Name |
Type |
Description |
idFile |
string
|
id que se asigna en el control HTML ol |
type |
string
|
extensión con los archivos permitidos |
kb |
string
|
tamaño máximo admitido en Kilobytes |
numFiles |
string
|
Número máximo de archivos que se pueden adjuntar |
#
(inner) cleanFileBtnAttr(btn)
Limpia los data atributos para adjuntar de un botón disparador del control adjuntar.
Parameters:
Name |
Type |
Description |
btn |
HTMLButtonElement
|
botón que dispara el modal para adjuntar |
Example
cleanFileBtnAttr(_$('#btnf1')[0]);
#
(inner) cleanFileInEdition()
Esta función se debe llamar antes de guardar los datos, si el formulario se devuelve
#
(inner) convertResponseAllFiles(response)
Convierte todos los files en el formulario de respuesta a la misma visualización que el formulario de edición
Parameters:
Name |
Type |
Description |
response |
boolean
|
true si se va a usar para formularios de respuesta, false si no |
#
(inner) convertResponseFile(dvFiles, response)
Carga todos los enlaces de los archivos adjuntos al nuevo esquema de control adjuntar
Parameters:
Name |
Type |
Description |
dvFiles |
HTMLDivElement
|
contenedor que debe tener las clases fw7Link y fileResp |
response |
boolean
|
true si se va a usar para formularios de respuesta, false si no |
#
(inner) existFile()
Valida que un mismo archivo no se adjunte 2 veces
Obtiene la configuración de un file desde el objeto global mediante el id.
Parameters:
Name |
Type |
Description |
idFile |
string
|
id que se asigna en el control HTML ol |
Returns:
objeto con la configuración del file
-
Type
-
object
#
(inner) getGridDataConf(f) → {object}
Obtiene los datos de una grid basado en el objeto de configuración del adjunto
Parameters:
Name |
Type |
Description |
f |
object
|
Objeto de configuración que se obtiene con la función getFileFormConf |
Returns:
objeto con la configuración de la grid
-
Type
-
object
#
(inner) getNewLiFile(url, name, remove) → {string}
Devuelve el contenido HTML necesario para crear un nodo li para el control adjuntar
Parameters:
Name |
Type |
Description |
url |
string
|
ruta del archivo adjunto |
name |
string
|
nombre del archivo |
remove |
boolean
|
true para que aparezca el botón para eliminar, false para que no aparezca |
Returns:
contenido HTML con el li listo
-
Type
-
string
#
(inner) initFiles()
Inicializa todos los controles de adjuntar en el formulario.
Todos los controles se buscan con la clase .btnAdjuntar
#
(inner) initModalUpload()
Inicializa el contenido HTML para el modal
#
(inner) loadFileInEdition()
Cargar los archivos ya guardados si el formulario se devuelve
#
(inner) removeFile(li, f)
Elimina un nodo li del control adjuntar
Parameters:
Name |
Type |
Description |
li |
HTMLLIElement
|
control li que se desea eliminar |
f |
object
|
objeto de configuración del file |
#
(inner) showHideBtnFile(idFile)
Muestra y oculta el botón que dispara la acción de adjuntar para adjuntar de cada control
Parameters:
Name |
Type |
Description |
idFile |
string
|
id que se asigna en el control HTML ol |
#
(inner) viewUpload(view)
Muestra y oculta el modal de adjuntar
Parameters:
Name |
Type |
Description |
view |
boolean
|
true para ver, false para ocultar |