前言
首先声明一下,我这个是对WebUploader开源上传控件的二次封装,底层还是WebUploader实现的,只是为了更简洁的使用他而已.
下面先介绍一下WebUploader
简介:
WebUploader是由Baidu WebFE(FEX)团队开发的一个简单的以HTML5为主,FLASH为辅的现代文件上传组件。在现代的浏览器里面能充分发挥HTML5的优势,同时又不摒弃主流IE浏览器,沿用原来的FLASH运行时,兼容IE6+,iOS 6+, android 4+。两套运行时,同样的调用方式,可供用户任意选用。
采用大文件分片并发上传,极大的提高了文件上传效率。
官网地址 //fex.baidu.com/webuploader/
有兴趣想自己玩的的可以直接移步官网
下面我们开始正文内容:
正文
从上面我们可以看到百度的这个WebUploader功能确实很强大,但是和所有的上传控件一样,使用起来比较繁琐比如下面这样:
你需要先引用一大堆相关的类库,
然后还要写好HTML
然后写大量的JS,比如:
- var uploader = WebUploader.create({
-
// swf文件路径
-
swf: BASE_URL + '/js/Uploader.swf',
-
// 文件接收服务端。
-
server: 'http://webuploader.duapp.com/server/fileupload.php',
-
// 选择文件的按钮。可选。
-
// 内部根据当前运行是创建,可能是input元素,也可能是flash.
-
pick: '#picker',
-
// 不压缩image, 默认如果是jpeg,文件上传前会压缩一把再上传!
-
resize: false
- });
- uploader.on( ‘uploadProgress’, function( file, percentage ) {
-
var $li = $( '#'+file.id ),
-
$percent = $li.find('.progress .progress-bar');
-
// 避免重复创建
-
if ( !$percent.length ) {
-
$percent = $('<div class="progress progress-striped active">' +
-
'<div class="progress-bar" role="progressbar" style="width: 0%">' +
-
'</div>' +
-
'</div>').appendTo( $li ).find('.progress-bar');
-
}
-
$li.find('p.state').text('上传中');
-
$percent.css( 'width', percentage * 100 + '%' );
- });
- //…以下省略,配置各种参数和情况
这些我们通通不要!,只要两句话,搞定我们的上传.如下: - //创建一个容器
- $(function () {
-
//渲染容器
-
$("#uploader").powerWebUpload({ auto: false,fileNumLimit:5 });
-
})
-
function GetFiles1() {
-
//获取上传的文件地址
-
var data = $("#uploader").GetFilesAddress();
-
alert(data[0])
-
}
简单快捷,效果如下:
我已经写好了bootstrap风格的css会自动引用,
支持多文件上传,
自动判别重复文件,
可选自动上传和手动上传,
可以页面中渲染多个上传控件,不冲突
然后一些WebUploader相关的配置参数都是可以直接自己配置的.
下面我们直接上我封装好的JS小插件(有点乱,大家凑合看):
- (function ($, window) {
-
var applicationPath = window.applicationPath === "" ? "" : window.applicationPath || "../..";
-
function SuiJiNum() {
-
return (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
-
}
-
function initWebUpload(item, options) {
-
if (!WebUploader.Uploader.support()) {
-
var error = "上传控件不支持您的浏览器!请尝试升级flash版本或者使用Chrome引擎的浏览器。<a target='_blank' href='http://se.360.cn'>下载页面</a>";
-
if (window.console) {
-
window.console.log(error);
-
}
-
$(item).text(error);
-
return;
-
}
-
//创建默认参数
-
var defaults = {
-
auto:true,
-
hiddenInputId: "uploadifyHiddenInputId", // input hidden id
-
onAllComplete: function (event) { }, // 当所有file都上传后执行的回调函数
-
onComplete: function (event) { },// 每上传一个file的回调函数
-
innerOptions: {},
-
fileNumLimit: undefined,//验证文件总数量, 超出则不允许加入队列
-
fileSizeLimit: undefined,//验证文件总大小是否超出限制, 超出则不允许加入队列。
-
fileSingleSizeLimit: undefined,//验证单个文件大小是否超出限制, 超出则不允许加入队列
-
PostbackHold: false
-
};
-
var opts = $.extend(defaults, options);
-
var hdFileData = $("#" + opts.hiddenInputId);
-
var target = $(item);//容器
-
var pickerid = "";
-
if (typeof guidGenerator36 != 'undefined')//给一个唯一ID
-
pickerid = guidGenerator36();
-
else
-
pickerid = (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
-
var uploaderStrdiv = '<div class="webuploader">'
-
debugger
-
if (opts.auto) {
-
uploaderStrdiv =
-
'<div id="Uploadthelist" class="uploader-list"></div>' +
-
'<div class="btns">' +
-
'<div id="' + pickerid + '">选择文件</div>' +
-
'</div>'
-
} else {
-
uploaderStrdiv =
-
'<div class="uploader-list"></div>' +
-
'<div class="btns">' +
-
'<div id="' + pickerid + '">选择文件</div>' +
-
'<button class="webuploadbtn">开始上传</button>' +
-
'</div>'
-
}
-
uploaderStrdiv += '<div style="display:none" class="UploadhiddenInput" >\
-
</div>'
-
uploaderStrdiv+='</div>';
-
target.append(uploaderStrdiv);
-
var $list = target.find('.uploader-list'),
-
$btn = target.find('.webuploadbtn'),//手动上传按钮备用
-
state = 'pending',
-
$hiddenInput = target.find('.UploadhiddenInput'),
-
uploader;
-
var jsonData = {
-
fileList: []
-
};
-
var webuploaderoptions = $.extend({
-
// swf文件路径
-
swf: applicationPath + '/Scripts/lib/webuploader/Uploader.swf',
-
// 文件接收服务端。
-
server: '/Home/AddFile',
-
deleteServer:'/Home/DeleteFile',
-
// 选择文件的按钮。可选。
-
// 内部根据当前运行是创建,可能是input元素,也可能是flash.
-
pick: '#' + pickerid,
-
//不压缩image, 默认如果是jpeg,文件上传前会压缩一把再上传!
-
resize: false,
-
fileNumLimit: opts.fileNumLimit,
-
fileSizeLimit: opts.fileSizeLimit,
-
fileSingleSizeLimit: opts.fileSingleSizeLimit
-
},
-
opts.innerOptions);
-
var uploader = WebUploader.create(webuploaderoptions);
-
//回发时还原hiddenfiled的保持数据
-
var fileDataStr = hdFileData.val();
-
if (fileDataStr && opts.PostbackHold) {
-
jsonData = JSON.parse(fileDataStr);
-
$.each(jsonData.fileList, function (index, fileData) {
-
var newid = SuiJiNum();
-
fileData.queueId = newid;
-
$list.append('<div id="' + newid + '" class="item">' +
-
'<div class="info">' + fileData.name + '</div>' +
-
'<div class="state">已上传</div>' +
-
'<div class="del"></div>' +
-
'</div>');
-
});
-
hdFileData.val(JSON.stringify(jsonData));
-
}
-
if (opts.auto) {
-
uploader.on('fileQueued', function (file) {
-
debugger;
-
$list.append('<div id="' + $(item)[0].id + file.id + '" class="item">' +
-
'<span class="webuploadinfo">' + file.name + '</span>' +
-
'<span class="webuploadstate">正在上传...</span>' +
-
'<div class="webuploadDelbtn">删除</div><br />' +
-
'</div>');
-
uploader.upload();
-
});
-
} else {
-
uploader.on('fileQueued', function (file) {
-
//队列事件
-
$list.append('<div id="' + $(item)[0].id + file.id + '" class="item">' +
-
'<span class="webuploadinfo">' + file.name + '</span>' +
-
'<span class="webuploadstate">等待上传...</span>' +
-
'<div class="webuploadDelbtn">删除</div><br />' +
-
'</div>');
-
});
-
}
-
uploader.on('uploadProgress', function (file, percentage) {
-
//进度条事件
-
var $li = target.find('#' + $(item)[0].id + file.id),
-
$percent = $li.find('.progress .bar');
-
// 避免重复创建
-
if (!$percent.length) {
-
$percent = $('<span class="progress">' +
-
'<span class="percentage"><span class="text"></span>' +
-
'<span class="bar" role="progressbar" style="width: 0%">' +
-
'</span></span>' +
-
'</span>').appendTo($li).find('.bar');
-
}
-
$li.find('span.webuploadstate').html('上传中');
-
$li.find(".text").text(Math.round(percentage * 100) + '%');
-
$percent.css('width', percentage * 100 + '%');
-
});
-
uploader.on('uploadSuccess', function (file, response) {
-
//上传成功事件
-
debugger
-
if (response.state == "error") {
-
target.find('#' + $(item)[0].id + file.id).find('span.webuploadstate').html(response.message);
-
} else {
-
target.find('#' + $(item)[0].id + file.id).find('span.webuploadstate').html('已上传');
-
$hiddenInput.append('<input type="text" id="hiddenInput'+$(item)[0].id + file.id + '" class="hiddenInput" value="' + response.message + '" />')
-
}
-
});
-
uploader.on('uploadError', function (file) {
-
target.find('#' + $(item)[0].id + file.id).find('span.webuploadstate').html('上传出错');
-
});
-
uploader.on('uploadComplete', function (file) {
-
//全部完成事件
-
target.find('#' + $(item)[0].id + file.id).find('.progress').fadeOut();
-
});
-
uploader.on('all', function (type) {
-
if (type === 'startUpload') {
-
state = 'uploading';
-
} else if (type === 'stopUpload') {
-
state = 'paused';
-
} else if (type === 'uploadFinished') {
-
state = 'done';
-
}
-
if (state === 'uploading') {
-
$btn.text('暂停上传');
-
} else {
-
$btn.text('开始上传');
-
}
-
});
-
//删除时执行的方法
-
uploader.on('fileDequeued', function (file) {
-
debugger
-
var fullName = $("#hiddenInput" + $(item)[0].id + file.id).val();
-
if (fullName!=null) {
-
$.post(webuploaderoptions.deleteServer, { fullName: fullName }, function (data) {
-
alert(data.message);
-
})
-
}
-
$("#"+ $(item)[0].id + file.id).remove();
-
$("#hiddenInput" + $(item)[0].id + file.id).remove();
-
})
-
//多文件点击上传的方法
-
$btn.on('click', function () {
-
if (state === 'uploading') {
-
uploader.stop();
-
} else {
-
uploader.upload();
-
}
-
});
-
//删除
-
$list.on("click", ".webuploadDelbtn", function () {
-
debugger
-
var $ele = $(this);
-
var id = $ele.parent().attr("id");
-
var id = id.replace($(item)[0].id, "");
-
var file = uploader.getFile(id);
-
uploader.removeFile(file);
-
});
-
}
-
$.fn.GetFilesAddress = function (options) {
-
var ele = $(this);
-
var filesdata = ele.find(".UploadhiddenInput");
-
var filesAddress = [];
-
filesdata.find(".hiddenInput").each(function () {
-
filesAddress.push($(this).val());
-
})
-
return filesAddress;
-
}
-
$.fn.powerWebUpload = function (options) {
-
var ele = this;
-
if (typeof WebUploader == 'undefined') {
-
var casspath = applicationPath + "/Scripts/webuploader/webuploader.css";
-
$("<link>").attr({ rel: "stylesheet", type: "text/css", href: casspath }).appendTo("head");
-
var jspath = applicationPath + "/Scripts/webuploader/webuploader.min.js";
-
$.getScript(jspath) .done(function() {
-
initWebUpload(ele, options);
-
})
-
.fail(function() {
-
alert("请检查webuploader的路径是否正确!")
-
});
-
}
-
else {
-
initWebUpload(ele, options);
-
}
-
}
- })(jQuery, window);
一些相关的比较重要的参数都写了注释,大家自行参考即可.
然后我们来使用他. - //引入JS,记得要先引入jquery
写好我们的JS和HTML如下:
这样就OK了,值得注意的是
powerWebUpload中的参数请参考官网的API
GetFilesAddress()方法会返回上传之后文件路径的数组,大家自行获取.
参考文章:http://blog.ncmem.com/wordpress/2023/09/11/%e7%99%be%e5%ba%a6webuploader%e5%bc%80%e6%ba%90%e4%b8%8a%e4%bc%a0%e6%8e%a7%e4%bb%b6/
欢迎入群一起讨论