早期實作頭像裁剪時,曾考慮 Flash 或 iframe 搭配後端裁切,最後選擇後者。後來行動端專案變多,Canvas + FormData 成為常見方案。但若要真正理解瀏覽器如何裁切並上傳圖片,必須先釐清 File、Blob、FileReader、ArrayBuffer、DataURL 等概念。
建立一個只包含 file input 的頁面,再用 JavaScript 取得元素。它的 files 屬性會回傳 FileList,而 FileList 中的每個項目都是 File。File 繼承自 Blob,並多出 name 屬性。
<!DOCTYPE html> <html lang="zh-Hant"> <head><meta charset="UTF-8"><title>File Demo</title></head> <body><input type="file"></body> </html>
var input = document.querySelector('input[type=file]');
選檔後若修改原始檔名再送出,可能會發生錯誤,因為 file input 指向的是檔案系統參考,而不是完整備份。Chrome 的 chrome://blob-internals/ 也能看到相關紀錄。
若要處理圖片,僅有參考並不足夠,必須把資料讀進瀏覽器。FileReader 提供 readAsArrayBuffer、readAsBinaryString、readAsDataURL、readAsText 等方法,讀取完成會觸發 load 事件。
input.addEventListener('change', function() {
var file = this.files[0], fr = new FileReader();
fr.onload = function() {
var blob = new Blob([this.result]);
};
fr.readAsArrayBuffer(file);
});
圖片是二進位檔案,但開發者通常透過幾種可讀形式操作:ArrayBuffer 接近原始二進位;BinaryString 以字元呈現位元組;DataURL 是 base64 編碼字串;Text 則經過文字編碼轉換。
ArrayBuffer 不能直接操作,需透過 ArrayBufferView,例如 Uint8Array、Int8Array、DataView 等,以不同位元寬度讀寫資料。
DataURL 格式如下:
data:[mimeType];base64,[base64(binaryString)]
var binaryString = atob(dataUrl.split(',')[1]);
var mimeType = dataUrl.split(',')[0].match(/:(.*?);/)[1];
Canvas 的 toDataURL 會輸出 DataURL,而 FormData 可附加 Blob。若要把 DataURL 轉成可上傳的 Blob,可以先取出 base64 中的 BinaryString,再轉成 Uint8Array,最後建立 Blob。
<!DOCTYPE html>
<html lang="zh-Hant">
<head><meta charset="UTF-8"><title>Upload Demo</title></head>
<body>
<form name='test'>
<input type="file" name='file'>
<input type="submit" value="提交">
</form>
<img src="" alt="">
<script>
var img = document.querySelector('img'), preview;
document.test.file.addEventListener('change', function() {
var fr = new FileReader();
fr.onload = function() {
preview = this.result;
img.src = preview;
};
fr.readAsDataURL(this.files[0]);
});
document.test.addEventListener('submit', function(e) {
e.preventDefault();
var binaryString = atob(preview.split(',')[1]),
mimeType = preview.split(',')[0].match(/:(.*?);/)[1],
length = binaryString.length,
u8arr = new Uint8Array(length),
blob, fd = new FormData(), xhr = new XMLHttpRequest();
while(length--) {
u8arr[length] = binaryString.charCodeAt(length);
}
blob = new Blob([u8arr.buffer], {type: mimeType});
fd.append('file', blob);
xhr.open('post', '/upload');
xhr.send(fd);
});
</script>
</body>
</html>
看起來可以直接 xhr.send(binaryString),但 send 收到字串時會進行 UTF-8 編碼,導致二進位資料被破壞。下圖比較正常 Blob 傳輸與字串傳輸的差異。
理解這些概念後,就能進一步實作更完整的客戶端圖片裁剪與上傳工具。