目录
本节目录收起
  • 功能用途说明
  • 配置项说明
  • 示例
  • 上传文件

    功能用途说明

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

     

    配置项说明

    名称

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

    此项为必填项。

    按钮值

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

    此项为必填项。

    文件类型

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

    此项为必填项。 

    文件大小

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

    此项为必填项。

    上传路径

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

    此项为必填项。

    完成监听

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

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

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

    显示路径

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

    此项为必填项。

    存为临时文件

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

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

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

    此项为必填项。

    引用

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

    值监听

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

    示例:

    设置完成监听为:uploadCallback。

    回调函数uploadCallback定义为

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

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

    示例

    上传文件按钮的设置:

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