不错的jquery上传插件jQuery File Upload 正确使用方式 很全面

大家好，欢迎来到IT知识分享网。

关于网页的上传组件比较常用的webuploader ，jQuery File Upload等，切图网在做前端项目切图的时候，不乏有一些后台或者前台需要用到上传组件的，虽然做前端开发不需要实现上传到服务器的功能，但是前台的功能还是需要做出来的，特别简单的可以jquery手写 基本能够用了，而复杂的时候就需要上一些插件，而选择插件的时候也比较讲究，插件尽可能要灵活 参数够多 或者一些扩展方法多， 可以满足不同的复杂情况，而jQuery File Upload则是相比之下比较不错的一款。

jQuery File Upload 是一个Jquery文件上传组件，支持多文件上传、取消、删除，上传前缩略图预览、列表显示图片大小，支持上传进度条显示；支持各种动态语言开发的服务器端。

官网链接：https://github.com/blueimp/jQuery-File-Upload/wiki

特点：拖放支持；上传进度条；图像预览；可定制和可扩展的；兼容任何服务器端应用平台（PHP, Python, Ruby on Rails, Java, Node.js, Go etc.）。

演示地址 https://blueimp.github.io/jQuery-File-Upload/

使用方法：

1. 需要加载的js文件：

jquey-1.8.3.min.js

jquery-ui-widget.js

jquery.iframe-transport.js

jquery.fileupload.js

2. html代码：

1. <input id=“fileupload” type=“file” name=“files[]” data-url=“server/php/” multiple>

3. js代码：

1. $(function () {
2. $(‘#fileupload’).fileupload({
3. dataType: ‘json’,
4. done: function (e, data) {
5. $.each(data.result.files, function (index, file) {
6. $(‘<p/>’).text(file.name).appendTo(document.body);
7. });
8. }
9. });
10. });

3.1 显示上传进度条：

1. 　$(‘#fileupload’).fileupload({
2. 　　progressall: function (e, data) {
3. 　　var progress = parseInt(data.loaded / data.total * 100, 10);
4. 　　$(‘#progress .bar’).css(
5. 　　‘width’,
6. 　　progress + ‘%’
7. 　　);
8. 　　}
9. 　　});

3.2 需要一个<div>容器用来显示进：

1. 　<div id=“progress”>
2. 　　<div class=“bar” style=“width: 0%;“></div>
3. 　　</div>

4. API

4.1 Initialization：

在上传按钮上调用fileupload()方法;

示例：

$(‘#fileupload’).fileupload();

4.2 Options :

1: url：请求发送的目标url

Type: string

Example: ‘/path/to/upload/handler.json’

2.Type: 文件上传HTTP请求方式，可以选择“POST”，“PUT”或者”PATCH”,

默认”POST”

Type: string

Example: ‘PUT’

3. dataType:希望从服务器返回的数据类型，默认”json”

Type: string

Example: ‘json’

4. autoUpload:默认情况下，只要用户点击了开始按钮被添加至组件的文件会立即上传。将autoUpload值设为true可以自动上传。

Type: boolean

Default: true

5. acceptFileTypes：允许上传的的文件类型

Example: /(\.|\/)(gif|jpe?g|png|xlsx)$/i

6. maxFileSize: 最大上传文件大小

Example: (999KB) //单位：B

7. minFileSize:最小上传文件大小

Example: (100KB) //单位：B

8.previewMaxWidth : 图片预览区域最大宽度

Example: 100 //单位：px

4.3 Callback Options:

使用方法一：函数属性

实例：

1. $(‘#fileupload’).fileupload({
2. 　　drop: function (e, data) {
3. 　　$.each(data.files, function (index, file) {
4. 　　alert(‘Dropped file: ‘ + file.name);
5. 　　});
6. 　　},
7. 　　change: function (e, data) {
8. 　　$.each(data.files, function (index, file) {
9. 　　alert(‘Selected file: ‘ + file.name);
10. 　　});
11. 　　}
12. 　　});

使用方法二：绑定事件监听函数

实例：

1. $(‘#fileupload’)
2. 　　　　.bind(‘fileuploaddrop’, function (e, data) {/* … */})
3. 　　　　.bind(‘fileuploadchange’, function (e, data) {/* … */});

每个事件名称都添加前缀：”fileupload”;

注意推荐使用第二种方法。

常用的回调函数：

1. add: 当文件被添加到上传组件时被触发

1. $(‘#fileupload’).bind(‘fileuploadadd’, function (e, data) {/* … */});

或者$(‘#fileupload’).on(‘fileuploadadd’, function (e, data) {/* … */});

2. processalways: 当一个单独的文件处理队列结束（完成或失败时）触发

3. progressall: 全局上传处理事件的回调函数

Example:

1. $(‘#fileupload’).on(‘fileuploadprogressall’, function (e, data) { //进度条显示
2. var progress = parseInt(data.loaded / data.total * 100, 10);
3. $(‘#progress .progress-bar’).css(
4. ‘width’,
5. progress + ‘%’
6. );
7. });

4. fail : 上传请求失败时触发的回调函数，如果服务器返回一个带有error属性的json响应这个函数将不会被触发。

5. done : 上传请求成功时触发的回调函数，如果服务器返回一个带有error属性的json响应这个函数也会被触发。

6. always : 上传请求结束时（成功，错误或者中止）都会被触发。