上传文件
功能用途说明
“上传文件”特殊效果,轻松在输入页面中上传文件。
配置项说明
名称
增强控件标识。该属性值应该保证页面内唯一,否则该控件被其他单元格引用时会出错。请参考 引用。
此项为必填项。
按钮值
按钮的显示内容,默认为“上传”。
此项为必填项。
文件类型
默认为"*.*",即所有文件类型;"*.js;*.jsp",表示显示js文件和jsp文件,各个类型以英文分号进行分隔。
此项为必填项。
文件大小
文件大小限制,单位为MB。默认为10。
此项为必填项。
上传路径
文件上传后在服务器的存放路径,相对于应用根路径,例如:"mis2/upload/temp"。
此项为必填项。
完成监听
上传完成后回调函数名称。 此属性为可选项。
完成监听的用法与值监听类似,都需要设置一个函数名,以及实现该函数;
不同的是触发的时机以及回调函数的参数,完成监听函数在上传文件结束后调用。
显示路径
是否用文本来显示上传后文件路径,默认为是。
此项为必填项。
存为临时文件
上传文件是否存为临时文件定时删除。默认不存为临时文件。
-
上传的文件即是最终文件。例如,某用户上传一张图片作为自己的头像,图片存在个人目录下。则直接指定个人目录地址,上传到此路径即可。
-
上传的文件只是临时文件,上传完成后要进一步处理。例如,需要对用户上传的其他图片需要做裁剪大小的处理,处理后的图片才是要存储的,这是就需要指定上传的是临时文件。
如果指定了是临时文件,则系统会自动在合适的时间(例如session过期时)将临时文件统一清除。
实际上,第二种情形也可以设置为非临时文件,但是对文件处理完成后,需要另写代码来完成清除文件的工作。
此项为必填项。
引用
其他单元格的名称。复制其他单元格的样式信息(包括边框、前景色、背景色、字体等内容)。请参考 引用。此属性为可选项。
值监听
设置单元格值变化时的回调函数。该单元格值(指的是单元格的value属性值)发生变化时,自动调用此函数,并传递当前单元格值。请参考 文件选择器 中的使用方法。此属性为可选项。
示例:
设置完成监听为:uploadCallback。
回调函数uploadCallback定义为
function uploadCallback(fileName, fileSavePath){ // ... }
其中,参数fileName为上传后的文件名称,如果是多个则用分号(;)分隔。参数fileSavePath为上传后的文件路径,如果是多个则用分号(;)分隔。
示例
上传文件按钮的设置:
如上图:添加上传文件后,无需特殊设置,即可一键添加上传文件按钮;如需添加其余效果,可参考【配置项说明】进行添加设置。