文件上传控件用于提供文件上传功能,其由两部分组成,一部分是核心的上传操作,另一部分是上传控件的界面
<wafctrl:fileupload id="upload" name="upload" url="/fileUploadDemo/upload.do?method=initalize"/>
var options = {id:"fileUpload1",style:"height:50px"};
var dom = waf.createDOM("fileUpload", options);
waf.appendDOM(waf("body"), dom);
waf.initComponent("fileUpload", options, dom);
<div id="tmpID" name="tmpName" class="ui-fileupload ui-widget ui-corner-all" ctrlrole="fileUpload" aria-disabled="false" style="" data-domcreated="true">
<div class="ui-fileupload-files cf">
<ul class="ui-fileupload-list"></ul>
</div>
<div class="ui-fileupload-buttonbar">
<span class="ui-fileupload-addFile">
<a>添加文件</a>
<input type="file" name="files[]" class="ui-fileupload-input">
</span>
</div>
</div>
<!--DOM创建好之后,使用js初始化控件-->
$("#id").wafFileUploadUI(options);
//调用方法
waf("#id").wafFileUploadUI('method', parameter...);
//eg:更改事件
waf("#id").wafFileUploadUI("option","onchange",fn);
使用正则表达式定义允许上传的文件类型
定义选择文件后是否自动上传
定义请求取消文件的地址
定义控件是否不可用
定义是否强制使用iframe方式上传文件
定义上传控件的高度
定义上传控件是否隐藏
定义文件上传控件的id
定义单个上传文件大小的上限
定义上传文件的最大个数
定义单个上传文件大小的下限
定义添加文件时是否可以多选
定义文件上传控件的名称
定义上传进度监听的间隔,单位为毫秒
定义上传进度监听的地址,只对iframe上传方式起作用.
定义是否顺序上传文件
定义上传控件的式样
定义上传控件的式样类
定义文件上传的地址
定义上传控件的宽度
禁用文件上传控件.[参考样例]
启用文件上传控件.[参考样例]
添加下载列表数据.[参考样例]
获得或设置F7控件某属性的值,当value参数存在时,设置控件的property属性值,且无返回值,否则返回控件的property属性值[参考样例]
添加文件前触发[参考样例]
参数说明:
- event-文件添加的event
- data-被添加文件的相关数据对象 :
- data参数说明:
fileInput- jQuery对象-上传对应的Input控件(已不是界面上的Input控件,只供参考)
files-Array[1]-对应上传的单个文件
originalFiles -Array[]-如果为多选,则是全部文件的数组,否则和files相同
返回值说明:
- 当返回值为false时,则不允许添加.
取消文件时触发[参考样例]
参数说明:
- event-文件取消的event
- data-取消文件的相关数据对象
- data参数说明:
context-jQuery对象-对应文件的展示区域
fileInput-jQuery对象-上传对应的Input控件(已不是界面上的Input控件,只供参考)
files-Array[1]-对应上传的单个文件
originalFiles-Array[]-如果为多选,则是全部文件的数组,否则和files相同
返回值说明:无
添加文件后触发[参考样例]
参数说明:
- event-文件添加的event
- data-被添加文件的相关数据对象
- data参数说明:
context-jQuery对象-对应文件的展示区域
fileInput-jQuery对象-上传对应的Input控件(已不是界面上的Input控件,只供参考)
files-Array[1]-对应上传的单个文件
originalFiles-Array[]-如果为多选,则是全部文件的数组,否则和files相同
返回值说明:无
上传文件完成时触发[参考样例]
参数说明:
- event-文件上传完成的event
- data-上传文件的相关数据对象
- data参数说明:
context-jQuery对象-对应文件的展示区域
fileInput-jQuery对象-上传对应的Input控件(已不是界面上的Input控件,只供参考)
files-Array[1]-对应上传的单个文件
originalFiles-Array[]-如果为多选,则是全部文件的数组,否则和files相同
返回值说明:无
上传文件失败时触[参考样例]
参数说明:
- event-文件上传失败的event
- data-上传文件的相关数据对象
- data参数说明:
context-jQuery对象-对应文件的展示区域
fileInput-jQuery对象-上传对应的Input控件(已不是界面上的Input控件,只供参考)
files-Array[1]-对应上传的单个文件
originalFiles-Array[]-如果为多选,则是全部文件的数组,否则和files相同
返回值说明:无
删除文件时触发[参考样例]
参数说明:
- event-文件删除的event
- context-删除文件时的ajax参数与上下文
- data参数说明:
context:jQuery对象-对应文件的展示区域
返回值说明:无
上传文件时触发[参考样例]
参数说明:
- event-文件上传的event
- data-上传文件的相关数据对象
- data参数说明
context-jQuery对象-对应文件的展示区域
fileInput-jQuery对象-上传对应的Input控件(已不是界面上的Input控件,只供参考)
files-Array[1]-对应上传的单个文件
originalFiles-Array[]-如果为多选,则是全部文件的数组,否则和files相同
返回值说明:无
全局文件上传开始时触发[参考样例]
参数说明:
- event:全局文件上传开始的event
返回值说明:无
全局文件上传结束时触发[参考样例]
参数说明:
- event:全局文件上传结束的event
返回值说明:无