DIV CSS 佈局教程網

上傳頭像實作:Base64 預覽與阿里雲兩段式上傳流程
編輯:關於JavaScript     

頭像上傳是個看似簡單、細節卻不少的題目。使用者希望「選完立刻看到預覽」,而後端又往往要求先向自家伺服器登記、再上傳到物件儲存。本文以阿里雲為例,把整個流程拆成五個步驟走一遍。

一、把圖片轉成 Base64 做預覽

FileReader 的 readAsDataURL() 可以直接把選中的檔案讀成 data URL,塞進 img 的 src 就能即時預覽,不必等上傳完成。

function preview(file) {//預覽圖片,取得圖片 base64
  var prevDiv = document.getElementById('preview');
  if (file.files && file.files[0]) {
    var reader = new FileReader();
    reader.onload = function(evt){
      prevDiv.innerHTML = '<img src="' + evt.target.result + '" />';
    }
    reader.readAsDataURL(file.files[0]);
  } else {
    //舊版 IE 的退路
    prevDiv.innerHTML = '<div class="img" style="filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale,src=\''
                      + file.value + '\')"></div>';
  }
}

建議先打個中斷點或 console.log 看看這個 base64 字串的長相——它會是以 data:image/jpeg;base64, 開頭的一長串文字。理解了這點,下一步就好懂了。

二、依上傳規範去掉 Base64 的檔頭

阿里雲這類服務要的是純粹的二進位內容,所以要先把 data:image/...;base64, 前綴削掉,再重新打包成 Blob 物件。

var binaryblob = function (s, type) {//組出 Blob 物件
  var byteString = atob(s);
  var array = [];
  for (var i = 0; i < byteString.length; i++) {
    array.push(byteString.charCodeAt(i));
  }
  return new Blob([new Int8Array(array)], {type: type});
};

var binaryPictureBlob = function (dataUrl, filterHead) {//base64 去頭
  var s = filterHead
    ? dataUrl.replace(/^data:image\/(png|jpeg|pjpeg|bmp|gif|x-png);base64,/, "")
    : dataUrl;
  return binaryblob(s, "image/jpeg");
};

這裡有個架構上的建議:這兩個函式應該放在 service 或 factory 裡,而不是寫在 controller 中。之後任何頁面有圖片上傳需求都能直接注入使用,也不會讓 controller 膨脹成一團。

三、第一次請求:向自家伺服器登記

$scope.save = function(){//保存
  var pic = binaryPictureBlob($('#preview img').attr('src'), true);//取得要上傳的資料
  console.log(pic);

  $http({//請求參數
    url: '',
    method: '',
    headers: {},
    data: {}
  }).success(function(data){
    console.log(data);
    //在這裡進行第二次請求
  }).error(function(err1, header1, config1, status1){//處理失敗
    console.log(err1, header1, config1, status1);
  })
}

點擊保存後,第一次請求會把圖片相關的標記資訊送到本地伺服器。伺服器回應的內容包含兩個位址:一個是該圖片最終的阿里雲 URL,一個是阿里雲的上傳目標網址。此時該圖片網址還不能用——檔案本身還沒真的傳上去。

四、第二次請求:PUT 到阿里雲

$http({
  method: 'PUT',
  url: data.UrlForPut,
  headers: {
    'Content-Type': ' '
  },
  data: pic  //去頭處理後的 blob
}).success(function(data2){
  $scope.imgSrc = data.Url;  //把伺服器回傳的 url 指派給圖片
}).error(function(err2, header2, config2, status2){//處理失敗
  console.log(err2, header2, config2, status2);
});

這裡有三個很容易踩到的坑

  1. 請求的 URL 要用第一次回傳的 data.UrlForPut,那是阿里雲預先配置好的固定上傳位址。
  2. Header 的 Content-Type 建議留空字串(或依阿里雲文件指定),否則阿里雲可能直接回錯誤。
  3. 圖片位址要取 data.Url,不是 data2.Url。 第二次請求的回應通常不包含可用網址,真正的位址來自第一次請求。這一點看起來矛盾,但卻是最常見的錯誤來源。

五、完整程式碼

把上面的片段組起來,就是一個可運作的示範頁面:

<!DOCTYPE html>
<html ng-app="webPhotos">
<head lang="zh-CN">
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<title>photos</title>
<style>
div{text-align:center;border:1px solid #ddd;}
button,div{margin:10px auto}
button{border:0;width:200px;height:30px;line-height:30px;font-size:1pc;color:#333;background-color:#0ff;cursor:pointer;border-radius:5px}
button:hover{background-color:#db7093}
#preview,.show-img{width:200px;height:200px;}
#preview img,.show-img img{width:100%;height:100%;}
.file{position:relative;display:block;width:200px;height:30px;line-height:30px;background:#9acd32;border-radius:5px;margin:10px auto;overflow:hidden;color:#1e88c7;text-decoration:none;text-indent:0}
.file input{position:absolute;font-size:75pt;right:0;top:0;opacity:0}
.file:hover{background:#aadffd;border-color:#78c3f3;color:#004974;text-decoration:none}
</style>
</head>
<body>
<div ng-controller="photos">
  <a href="javascript:;" class="file">
    <span>選擇文件</span>
    <input type="file" onchange="preview(this)" />
  </a>
  <button class="save" ng-click="save()">保存</button>
  <h2>頭像預覽</h2>
  <div id="preview"></div>
  <h2>上傳成功後展示頭像</h2>
  <div class="show-img">
    <img ng-src={{imgSrc}} alt=""/>
  </div>
</div>

<script type="text/javascript" src="//cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<script src="https://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script>
<script>
function preview(file) {//預覽圖片,取得 base64
  var prevDiv = document.getElementById('preview');
  if (file.files && file.files[0]) {
    var reader = new FileReader();
    reader.onload = function(evt){
      prevDiv.innerHTML = '<img src="' + evt.target.result + '" />';
    }
    reader.readAsDataURL(file.files[0]);
  } else {
    prevDiv.innerHTML = '<div class="img" style="filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale,src=\''
                      + file.value + '\')"></div>';
  }
}
//以上程式碼最好寫在 service 或 factory 裡

angular.module('webPhotos', ['ng'])
  .controller('photos', function($scope, $http){

    var binaryblob = function (s, type) {//Blob 物件
      var byteString = atob(s);
      var array = [];
      for (var i = 0; i < byteString.length; i++) {
        array.push(byteString.charCodeAt(i));
      }
      return new Blob([new Int8Array(array)], {type: type});
    };

    var binaryPictureBlob = function (dataUrl, filterHead) {//base64 去頭
      var s = filterHead
        ? dataUrl.replace(/^data:image\/(png|jpeg|pjpeg|bmp|gif|x-png);base64,/, "")
        : dataUrl;
      return binaryblob(s, "image/jpeg");
    };

    $scope.save = function(){//保存
      var pic = binaryPictureBlob($('#preview img').attr('src'), true);

      $http({//第一次:上傳到本地伺服器
        url: '',
        method: '',
        headers: {},
        data: {}
      }).success(function(data){
        //此時本地已成功,但實際只上傳了與此圖片相關的標記,圖片本身尚未上傳

        $http({//第二次:上傳到阿里雲
          method: 'PUT',
          url: data.UrlForPut,//本地已產生位址,但要上傳到阿里雲後才生效
          headers: {
            'Content-Type': ' ' //避免阿里雲上傳報錯,或依阿里雲要求設定 header
          },
          data: pic
        }).success(function(data2){
          $scope.imgSrc = data.Url;//注意是 data.Url,不是 data2.Url
        }).error(function(err2, header2, config2, status2){
          console.log(err2, header2, config2, status2);
        });

      }).error(function(err1, header1, config1, status1){
        console.log(err1, header1, config1, status1);
      })
    }
  })
</script>
</body>
</html>

流程回顧

整體可以概括成一句話:先向後端拿通行證,再拿通行證去傳檔案。本地伺服器負責產生上傳用的簽章網址與最終存取網址,瀏覽器則拿著簽章把 Blob 直接 PUT 到物件儲存。這樣做的好處是檔案不經過你的應用伺服器,省下大量頻寬。

測試時別忘了把 url、method 這些空白欄位補上你自己的端點,否則請求是不會成功的。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved