天天看点

七牛图片上传的使用心得[JS篇]

上次写了七牛图片上传的使用心得[PHP篇],主要说的是后端如何为前端生成Token

其实上传图片,后端还相对简单一些,因为使用第三方就是给后端减轻压力,前端相对来说就比较复杂

你可能需要在前端实现一些交互良好的功能:

1.用户点击选择图片

2.用户直接把图片拖拽到div中

3.用户会希望看到上传进度

4.用户希望看到预览图

在开始下面的步骤前,请确保:

1.后端可以正常生成token

2.你下载了plupload.full.min.js和qiniu.min.js文件

开始第一步

1.在页面引入这两个文件,可能需要按照顺序,这个顺序我也忘了,你自己摸索一下。 2.编写一个函数,返回一个参数对象。

var qiniu_upload_params = (params, init) => {
    var obj_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时才生效
            // do something with key here
            var type = file.type;
            type = type.split("/");
            return 'image-tmp/'+ file.id+ "."+ type[1];
        }
    }
    Object.assign(obj_init, init);
    var obj = {
      runtimes: 'html5,flash,html4',      // 上传模式,依次退化
      browse_button: 'pickfiles',         // 上传选择的点选按钮,必需
      // 在初始化时,uptoken,uptoken_url,uptoken_func三个参数中必须有一个被设置
      // 切如果提供了多个,其优先级为uptoken > uptoken_url > uptoken_func
      // 其中uptoken是直接提供上传凭证,uptoken_url是提供了获取上传凭证的地址,如果需要定制获取uptoken的过程则可以设置uptoken_func
      // uptoken : '<Your upload token>', // uptoken是上传凭证,由其他程序生成
      uptoken_url: '*********',         // Ajax请求uptoken的Url,强烈建议设置(服务端提供)
      // uptoken_func: function(){    // 在需要获取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: obj_init
    }
    Object.assign(obj, params);
    return obj;
}
           

做好这个参数以后,使用起来就非常简单了(注释很清晰,不懂的可以留言问我) 你可以像下面这样使用刚才编写的函数,其中image_showdiv是父容器,image_show是字容器,也作为预览图片使用。

var imageupload = Qiniu.uploader(qiniu_upload_params({
        container: "image_showdiv",
        browse_button: "image_show",
        drop_element: "image_show",
    },{
        FileUploaded: function(up, file, info){
            var rs = JSON.parse(info);
            $("#image_show").css("backgroundImage", "url('*********"+ rs.key+ "')");
            $("#sysfrontendhomebanner-image").val(rs.key);
        }
    }));
           

这只是一个非常基础的使用 上传图片成功后,客户端还得再下载才能看到图片,其实客户选择完图片以后,就可以立刻取到图片然后显示在你想显示的位置了。 还有,为了防止用户反复上传,最好还是等几秒再上传到七牛,如果图片少,干脆提交表单的时候再上传图片。 这里并没有限制用户上传资源的类型,也就是说可以上传任何东西 没有限制用户上传的个数,用户可能会一次上传很多。 这些东西大家可以摸索一下...我觉得写代码就跟做实验一样