之前在开发项目的过程中用到了七牛图片上传功能,支持拖拽上传,在次整理一下笔记分享给大家,主要用到上传下面的三个模块和缩略图功能。
功能简介:
-
上传
-
html5 模式大于 4 M 时可分块上传,小于 4 M 时直传
-
Flash、html4 模式直接上传
-
继承了 Plupload 的功能,可筛选文件上传、拖曳上传等
-
-
下载(公开资源)
-
数据处理(图片)
-
imageView2(缩略图)
imageMogr2(高级处理,包含缩放、裁剪、旋转等)
imageInfo (获取基本信息)
exif (获取图片 EXIF 信息)
watermark (文字、图片水印)
pipeline (管道,可对 imageView2、imageMogr2、watermark 进行链式处理)
一、引入 Plupload
本 SDK 上传功能基于Plupload插件封装,所以需要下载Plupload,建议使用 2.1.1 ~ 2.1.9。您也可以访问开放静态文件 CDN ,搜索 plupload ,使用 CDN 加速的静态文件地址。
上传
在页面中引入 plupload,plupload.full.min.js(产品环境)或引入 plupload.dev.js 和 moxie.js(开发调试)
在页面中引入 qiniu.min.js(生产环境)或 qiniu.js(开发调试)
初始化 uploader (请确保在执行初始化时,页面已经引入 plupload):
引入成功后就可以进行代码的编写了:
var uploader = Qiniu.uploader({
runtimes: 'html5,flash,html4', // 上传模式,依次退化
browse_button: 'pickfiles', // 上传选择的点选按钮,必需
// 在初始化时,uptoken,uptoken_url,uptoken_func三个参数中必须有一个被设置
// 切如果提供了多个,其优先级为uptoken > uptoken_url > uptoken_func
// 其中uptoken是直接提供上传凭证,uptoken_url是提供了获取上传凭证的地址,如果需要定制获取uptoken的过程则可以设置uptoken_func
uptoken : '', // uptoken是上传凭证,由其他程序生成
// uptoken_url: '/uptoken', // Ajax请求uptoken的Url,强烈建议设置(服务端提供)
// uptoken_func: function(file){ // 在需要获取uptoken时,该方法会被调用
// // do something
// return uptoken;
// },
get_new_uptoken: false, // 设置上传文件的时候是否每次都重新获取新的uptoken
// downtoken_url: '/downtoken',
// Ajax请求downToken的Url,私有空间时使用,JS-SDK将向该地址POST文件的key和domain,服务端返回的JSON必须包含url字段,url值为该文件的下载地址
// unique_names: true, // 默认false,key为文件名。若开启该选项,JS-SDK会为每个文件自动生成key(文件名)
// save_key: true, // 默认false。若在服务端生成uptoken的上传策略中指定了sava_key,则开启,SDK在前端将不对key进行任何处理
domain: '', // bucket域名,下载资源时用到,必需
container: 'container', // 上传区域DOM ID,默认是browser_button的父元素
max_file_size: '100mb', // 最大文件体积限制
flash_swf_url: 'path/of/plupload/Moxie.swf', //引入flash,相对路径
max_retries: 3, // 上传失败最大重试次数
dragdrop: true, // 开启可拖曳上传
drop_element: 'container', // 拖曳上传区域元素的ID,拖曳文件或文件夹后可触发上传
chunk_size: '4mb', // 分块上传时,每块的体积
auto_start: true, // 选择文件后自动上传,若关闭需要自己绑定事件触发上传
//x_vars : {
// 查看自定义变量
// 'time' : function(up,file) {
// var time = (new Date()).getTime();
// do something with 'time'
// return time;
// },
// 'size' : function(up,file) {
// var size = file.size;
// do something with 'size'
// return size;
// }
//},
init: {
'FilesAdded': function(up, files) {
plupload.each(files, function(file) {
// 文件添加进队列后,处理相关的事情
});
},
'BeforeUpload': function(up, file) {
// 每个文件上传前,处理相关的事情
},
'UploadProgress': function(up, file) {
// 每个文件上传时,处理相关的事情
},
'FileUploaded': function(up, file, info) {
// 每个文件上传成功后,处理相关的事情
// 其中info是文件上传成功后,服务端返回的json,形式如:
// {
// "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
// "key": "gogopher.jpg"
// }
// 查看简单反馈
// var domain = up.getOption('domain');
// var res = parseJSON(info);
// var sourceLink = domain +"/"+ res.key; 获取上传成功后的文件的Url
},
'Error': function(up, err, errTip) {
//上传出错时,处理相关的事情
},
'UploadComplete': function() {
//队列文件处理完毕后,处理相关的事情
},
'Key': function(up, file) {
// 若想在前端对每个文件的key进行个性化处理,可以配置该函数
// 该配置必须要在unique_names: false,save_key: false时才生效
var key = "";
// do something with key here
return key
}
}
});
// domain为七牛空间对应的域名,选择某个空间后,可通过 空间设置->基本设置->域名设置 查看获取
// uploader为一个plupload对象,继承了所有plupload的方法
plupload上传图片的功能还有很多,在这里不多做介绍,下面是这个上传功能的一个Demo演示,下一篇说下缩略图策略。
上传Demo: http://jssdk.demo.qiniu.io/