html5uploader
简单基于h5的上传文件上传插件(根据网上资源修改)
使用方法
- 页面引用css与js
- 定义一个div
<div id="uploader"></div>
- 调用
$('#uploader').html5uploader({
auto:true,
multi:false,
basePath:'/Scripts/h5uploader/',
savePath:'/Upload/Files/'
});
参数说明
字段 | 类型 | 默认值 | 说明 |
---|---|---|---|
fileTypeExts | 数组 | [] | 允许上传的文件类型,文件后缀字符集合 ['.docx','.xls'] |
auto | 布尔 | false | 自动上传 |
multi | 布尔 | true | 多文件 |
buttonText | 字符 | 选择文件 | 上传按钮上的文字 |
removeTimeout | 数字 | 1000 | 上传完成后进度条的消失时间(毫秒) |
formData | Object | - | 附加的参数 |
fileDataName | 字符 | fileData | 上传时的文件参数名称 |
initQueue | 数组 | [] | 初始化显示的队列,编辑时传入已保存文件的路径列表,{name:'显示的名称',path:'服务器路径'} |
maxQueue | 数字 | 999 | 允许上传的最大数 |
fileSizeLimit | 数字 | 0 | 文件大小限制(单位KB),0时表示不限制 |
savePath | 字符 | 空 | 文件保存的相对路径(即服务器路径) 必选 |
saveFileNameTemplate | 字符 | '${prefix}_${fileName}' | 保存的文件名模版,可用参数 ${prefix}:前缀,格式为yyyyMMddHHmmssfff的时间戳 ${fileName}:原始文件名 |
basePath | 字符 | 空 | 插件的基础路径,即h5uploader的文件夹路径,如:/Scripts/h5uploader/ 必选 |
事件
事件 | 参数 | 说明 |
---|---|---|
onInit | 无 | 初始化时的动作 |
onUploadStart | file:文件对象 | 上传开始时的动作 |
onUploadSuccess | file:文件对象 res:服务器响应信息 |
上传成功的动作 |
onUploadComplete | file:文件对象 res:服务器响应信息 |
上传完成的动作 |
onUploadError | file:文件对象 res:服务器响应信息 |
上传失败的动作 |
onSelectedFiles | files:选择的文件数组 | 选择文件后的事件,接收一个布尔的返回值,false时取消上传 |
onDeletedFile | filepath:包含文件名的文件完整相对路径 | 删除队列中的文件时触发 |
onFileTypeError | 无 | 文件类型不允许时的回调 |
onFileSizeError | 无 | 文件大小超出限制时的回调 |
onQueueFull | 无 | 文件个数超出限制的回调 |