上传文件- 单元格-属性及效果 -表单工具
目录

上传文件

功能用途说明

“上传文件”特殊效果,轻松在输入页面中上传文件。

 

配置项说明

名称

增强控件标识。该属性值应该保证页面内唯一,否则该控件被其他单元格引用时会出错。请参考 引用

此项为必填项。

按钮值

按钮的显示内容,默认为“上传”。

此项为必填项。

文件类型

默认为"*.*",即所有文件类型;"*.js;*.jsp",表示显示js文件和jsp文件,各个类型以英文分号进行分隔。

此项为必填项。 

文件大小

文件大小限制,单位为MB。默认为10。

此项为必填项。

上传路径

文件上传后在服务器的存放路径,相对于应用根路径,例如:"mis2/upload/temp"。

此项为必填项。

完成监听

上传完成后回调函数名称。 此属性为可选项。

完成监听的用法与值监听类似,都需要设置一个函数名,以及实现该函数;

不同的是触发的时机以及回调函数的参数,完成监听函数在上传文件结束后调用。

显示路径

是否用文本来显示上传后文件路径,默认为是。

此项为必填项。

存为临时文件

上传文件是否存为临时文件定时删除。默认不存为临时文件。

如果指定了是临时文件,则系统会自动在合适的时间(例如session过期时)将临时文件统一清除。

实际上,第二种情形也可以设置为非临时文件,但是对文件处理完成后,需要另写代码来完成清除文件的工作。

此项为必填项。

引用

其他单元格的名称。复制其他单元格的样式信息(包括边框、前景色、背景色、字体等内容)。请参考 引用。此属性为可选项。

值监听

设置单元格值变化时的回调函数。该单元格值(指的是单元格的value属性值)发生变化时,自动调用此函数,并传递当前单元格值。请参考 文件选择器 中的使用方法。此属性为可选项。

示例:

设置完成监听为:uploadCallback。

回调函数uploadCallback定义为

function uploadCallback(fileName, fileSavePath){     // ... }

其中,参数fileName为上传后的文件名称,如果是多个则用分号(;)分隔。参数fileSavePath为上传后的文件路径,如果是多个则用分号(;)分隔。

示例

上传文件按钮的设置:

如上图:添加上传文件后,无需特殊设置,即可一键添加上传文件按钮;如需添加其余效果,可参考【配置项说明】进行添加设置。