# html5uploader

**Repository Path**: wenjq/html5uploader

## Basic Information

- **Project Name**: html5uploader
- **Description**: h5的上传文件上传插件
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2018-08-03
- **Last Updated**: 2022-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# html5uploader
简单基于h5的上传文件上传插件（根据网上资源修改）
## 使用方法

* 页面引用css与js
* 定义一个div  
	
```html
<div id="uploader"></div>
```
		
* 调用

```javascript
$('#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}'|保存的文件名模版，可用参数 <br/>${prefix}:前缀，格式为yyyyMMddHHmmssfff的时间戳<br/>${fileName}:原始文件名
basePath|字符|空|插件的基础路径，即h5uploader的文件夹路径，如：/Scripts/h5uploader/ 必选
## 事件

事件|参数|说明
----|--|----
onInit|无|初始化时的动作
onUploadStart|file：文件对象|上传开始时的动作
onUploadSuccess|file:文件对象 <br/> res:服务器响应信息|上传成功的动作
onUploadComplete|file:文件对象 <br/> res:服务器响应信息|上传完成的动作
onUploadError|file:文件对象 <br/> res:服务器响应信息|上传失败的动作
onSelectedFiles|files:选择的文件数组|选择文件后的事件，接收一个布尔的返回值，false时取消上传
onDeletedFile|filepath:包含文件名的文件完整相对路径|删除队列中的文件时触发
onFileTypeError|无|文件类型不允许时的回调
onFileSizeError|无|文件大小超出限制时的回调
onQueueFull|无|文件个数超出限制的回调