頭像上傳是個看似簡單、細節卻不少的題目。使用者希望「選完立刻看到預覽」,而後端又往往要求先向自家伺服器登記、再上傳到物件儲存。本文以阿里雲為例,把整個流程拆成五個步驟走一遍。
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, 開頭的一長串文字。理解了這點,下一步就好懂了。
阿里雲這類服務要的是純粹的二進位內容,所以要先把 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,一個是阿里雲的上傳目標網址。此時該圖片網址還不能用——檔案本身還沒真的傳上去。
$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);
});
data.UrlForPut,那是阿里雲預先配置好的固定上傳位址。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 這些空白欄位補上你自己的端點,否則請求是不會成功的。