Easyui-fileUpload使用手册V1.6.4日期版本说明编写2016.4.22V1.1基于jqueryui框架编写的通用文件上传屈福兴2016.4.27V1.21.修复:.提示已存在的文件,上传时也上传了.可以用金格控件打开的文件,提示不能打开2.优化:.默认打开inputfile的multiple属性,支持ctrl选择多个文件上传.添加autoCloseOnEsc属性,true:esc关闭窗口.修改部分提示信息样式,对里面的重要内容添加颜色以区分屈福兴2016.4.29V1.3优化:.已上传的文件,上传按钮禁用。.如果文件后缀没有指定时,则可以选择任何文件。.解决用JS初始化时,回显表格size无法铺满容器,高度无法显示所有记录,宽度不能到100%。添加:1.添加通过触发按钮弹出窗口(文件选择)。2.上传文件回显可以自定义,由参数控制是否使用自动生成的datagrid显示。3.添加方法:获得已经上传的文件信息[getUploadFiles]4.添加方法:刷新文件回显表格[reloadFileGrid]5.添加属性:echoType文件上传后,回显方式选择,默认:11:在当前容器下生成datagrid表格,提供“添加、修改、删除、查看、下载”等功能,可以通过参数对按钮权限进行配置。2:以文件名列表形式展示,一个文件名称就是一行3:不回显,根据控件提供的方法(getUploadFiles详见使用手册),自己定义回显样式6.添加属性:fileWrapechoType=2,文件是否换行,true:一个文件一行,false:都在一行7.文件上传完毕后,回显方式增加以menuButton形式显示。屈福兴2016.5.3V1.4.1.添加属性:uploadFace上传界面类型,0:(默认)弹出dialog窗口和表格;1:直接选择上传文件;2.添加方法:刷新回显文件-menubutton形式[reloadFileMenuBtn]参数:queryParams,json类型3.添加方法:reloadFile,刷新回显文件,根据echoType的值,自动去判断回显方式[reloadFile]参数:queryParams,json类型4.menubutton形式的回显文件,删除时confirm确认后再删除。屈福兴2015.5.4V1.51.添加属性:draggable:窗口是否可以拖拽,默认:false,zIndex:窗口层的zIndex,默认为99999992.添加属性:zipFile下载时,是否压缩文件,仅限于下载单个文件时,多个文件下载,只能放在zip压缩包中。下载时文件默认为下载文件的名称,也可以通过控件属性指定(zipPackageName)true:压缩文件;false:不压缩文件;默认:false3.添加属性:shadow弹出窗口-如果设置为true,在窗体显示的时候显示阴影.4.添加属性:msgAlign消息位置'top,bottom',默认:'bottom'5.添加方法:设置控件的属性property参数:key:可以为String,或者json对象value:String使用:1.$('#objId').fileUpload('property','fileGuid','-1');2.$('#objId').fileUpload('property',{'fileGuid':'-1','msgAlign':'bottom'});6.添加事件:onDeleteFile删除文件前调用参数:fileIdList数组类型[],里面为选择的文件fileId返回:booleantrue:执行删除,false:终止删除7.onDeleteFileSuccess删除成功后调用参数:datajson类型{type:'info/error',msg:'删除成功!'},fileIdList数组类型[],里面为选择的文件fileId屈福兴2016.5.5V1.6优化:1.编辑按钮显示时,查看按钮就默认隐藏掉。如果编辑按钮隐藏,则查看按钮根据配置是否隐藏。修复:1.isAdd属性无法控制添加按钮是否显示。2.控件多次调用时,只用第一次时初始化,以后都是更新配置参数。屈福兴2016.5.6V1.6.1优化:1.根据“附件”td,回显表格所在td,页面宽度,自动计算分配宽度,防止附件td被挤压;2.添加属性:cbGridPrevTdWidth,回显为grid表格时,附件所在td的前一个td的宽度,单位可以是%或者px屈福兴默认:cbGridPrevTdWidth:'15%'2016.5.16V1.6.2添加方法:addmenutiem(echoType=2)回显为menubutton时,为menubutton添加自定义条目屈福兴2016.5.16V1.6.31.优化office文件打开方法,使之适用IE8,打开后根据屏幕分辨率最大化..优化文件上传时,文件大小计算方法,适合IE8-11,IE9以下版本,对于浏览器不能调用activex计算文件大小的,给出提示。.优化预览文件datagrid列宽,文件路径太长时使用省略号代替。2.添加属性:loadtime默认false,显示控件加载时间(单位:秒,只有第一次加载时显示)添加属性:excludeSuffixs不能上传的文件类型,excludeSuffixs不为空时,suffixs失效添加属性:forceCheck强制上传文件大小检查,如果不符合则不能上传,默认:false添加属性:spaceSumibtFilesspace空格键上传文件,默认:true屈福兴2016.5.19V1.6.4添加属性localViewFile预览界面的文件,是否可以调用本地office打开查看,Booleantrue:可以打开屈福兴1.例子Demo1:公共组件例子pages\commonPlusDemo\commonPlusDemo.jspJS引入:scripttype=”text/javascript”src=”${contextPath}/resources/js/jquery-fileUpload.js”/scriptHtml:divid=”upload01”data-options=”fileGuid:-1,//业务附件对应的guid,必填isAdd:true,//设置按钮的权限,默认:trueisEdit:true,//默认:trueisDel:true,//默认:trueisView:true,//默认:trueisDownload:true,//默认:trueisdebug:true,//默认:trueclass=”easyui-fileUpload”/divDemo2:年度计划JSP:pages\plan\year\edit_workplan.jspDemo3:menubutton回显文件Demo4:简单文件上传(上传界面简化)Demo5:简单文件上传2(上传界面简化)2.属性列表属性名描述默认值类型isdebug控件出错时是否输出调试信息falsebooleanautoCloseOnEsc键盘ESC键关闭打开窗口truebooleantriggerId触发控件容器ID,会自动给它添加click事件,单击后会打开上传文件窗口空stringsuffixs上传文件类型wps,doc,docx,xls,xlsx,zip,rar,txt,jpg,bmpstringmaxFileCount最大上传文件个数,默认:10个10数字maxSingleFileSize单位文件最大size(单位K),默认10M=10240K51200数字fileDialog弹出窗口dom对象domfileDatagrid弹出窗口里文件列表对dom象(datagrid控件)domsubmitFileForm提交file用的form表单dommsgShowType消息显示方式1:弹出,2:窗口里面提示,3:1,2都有,默认:22stringmsgAlign消息位置'top,bottom'默认:toptopstringmsgTimeout消息超时时间,单位毫秒,默认:5000,即:5s5000数字fileGridTitle回显表格文件title文件列表stringsubmitFilesUrl文件上传保存对应的url/ais/commonPlug/commonUploadFiles.actionstringdeleteFilesUrl删除文件对应的URL/ais/commonPlug/deleteFiles.actionstringdownloadFilesUrl下载文件对应的URL/ais/commonPlug/downloadFiles.actionstringeditFileUrl编辑文件对应的URL/ais/pages/commons/file/iweb.jsp?fileId=stringzipPackageName下载文件ZIP压缩包名称附件压缩包.zipstringcloseAfterUpload上传完毕后关闭窗口falsebooleanclearCache打开时是否清空上次的上传记录truebooleandialogOptions弹出窗口默认参数{title:通用文件上传,resizable:true,collapsible:true,closed:true,modal:true,iconCls:'icon-import'}jsonhelpMsg文件上传说明-帮助说明通用文件上传,支持对类型、大小、数量、重复文件的检查,支持多文件上传stringfileGuid具体业务对应附件的guidstringisAdd是否可以添加附件truebooleanisEdit是否可以编辑附件truebooleanisDel是否可以删除附件truebooleanisView是否可以查看附件truebooleanisDownload是否可以下载附件truebooleanfileCallbackGridUrl回显表格查询URL/ais/commonPlug/genUploadFileTable.actionstringcallbackGridParams回显表格查询参数{query_eq_guid:'',boName:'FileBean',pkName:'fileId'}jsoneditFileType金格控件可以编辑的文件类型[application/vnd.ms-excel,xls,application/msword,doc,application/vnd.openxmlformats-officedocument.wordprocessingml.document,docx,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,xlsx,application/vnd.ms-works,wps]arraycallbackGridHeight回显表格的高度(默认只正好显示5条记录)250数字showCbFilesGrid是否生成回显文件表格,特殊情况下可以自定义回显表格truebooleanmaxQueryFiles回显时,一次最大查询出的文件数20数字echoType文件上传后,回显方式选择,默认:11:在当前容器下生成datagrid表格,提供“添加、修改、删除、查看、下载”等功能,可以通过参数对按钮权限进行配置。2:以文件名列表形式展示,一个文件名称就是一行(通过fileWrap设置是否换行)3:不回显,根据控件提供的方法(getUploadFiles详见使用手册),自己定义回显样式1数字fileWrapechoType=2,文件是否换行,true:一个文件一行,false:都在一行truebooleanuploadFace上传界面类型,0:(默认)弹出dialog窗口和表格;1:直接选择上传文件;0数字draggable窗口是否可以拖拽