七牛圖檔上傳的使用心得[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);
        }
    }));
           

這隻是一個非常基礎的使用 上傳圖檔成功後，用戶端還得再下載下傳才能看到圖檔，其實客戶選擇完圖檔以後，就可以立刻取到圖檔然後顯示在你想顯示的位置了。 還有，為了防止使用者反複上傳，最好還是等幾秒再上傳到七牛，如果圖檔少，幹脆送出表單的時候再上傳圖檔。 這裡并沒有限制使用者上傳資源的類型，也就是說可以上傳任何東西 沒有限制使用者上傳的個數，使用者可能會一次上傳很多。 這些東西大家可以摸索一下...我覺得寫代碼就跟做實驗一樣