HTML5 提供了 File 與 FileReader 兩個介面,前者負責描述檔案的 metadata,後者負責把檔案內容讀進來。兩者搭配,就能在使用者選檔後、尚未上傳前先顯示預覽。
<html>
<body>
<div id="test-image-preview"
style="border: 1px solid rgb(204, 204, 204); width: 100%; height: 200px;
background-size: contain; background-repeat: no-repeat;
background-position: center center;">
</div>
<br/>
<div id="test-file-info"></div>
<br/>
<input type="file" id="test-image-file">
<script type="text/javascript">
var fileInput = document.getElementById('test-image-file'),
info = document.getElementById('test-file-info'),
preview = document.getElementById('test-image-preview');
// 監聽 change 事件
fileInput.addEventListener('change', function () {
// 先清除舊的背景圖
preview.style.backgroundImage = '';
// 檢查是否有選檔
if (!fileInput.value) {
info.innerHTML = '沒有選擇文件';
return;
}
// 取得 File 物件
var file = fileInput.files[0];
// 顯示檔案資訊
info.innerHTML = '文件: ' + file.name + '<br>'
+ '大小: ' + file.size + '<br>'
+ '修改: ' + file.lastModifiedDate;
if (file.type !== 'image/jpeg' &&
file.type !== 'image/png' &&
file.type !== 'image/gif') {
alert('不是有效的圖片文件!');
return;
}
// 建立 FileReader 並讀檔
var reader = new FileReader();
reader.onload = function(e) {
var data = e.target.result;
// 'data:image/jpeg;base64,/9j/4AAQSk...(base64編碼)...'
preview.style.backgroundImage = 'url(' + data + ')';
};
// 以 DataURL 形式讀取
reader.readAsDataURL(file);
});
</script>
</body>
</html>
以 DataURL 形式讀出的結果是一段字串,長得像 data:image/jpeg;base64,/9j/4AAQSk...。它可以直接餵給 background-image 或 <img src>。若需要送給伺服器,把 base64, 之後的部分擷取出來傳送,伺服器端做 Base64 解碼即可還原成原始的二進位內容。
這段程式示範了 JavaScript 一個關鍵特性:單執行緒執行模式。瀏覽器的 JavaScript 引擎在跑程式碼時,任何時刻都不會有第二條執行緒同時執行。
你可能會問:單執行緒如何處理多任務?
答案是以非同步呼叫為手段。例如:
reader.readAsDataURL(file);
這行只是「發起」一個讀檔操作,隨即返回,不會停下來等檔案讀完。因為是非同步,我們無法预知它何時完成,因此必須先掛上回呼函式:
reader.onload = function(e) {
// 檔案讀取完成後,引擎會自動呼叫這個函式
};
當讀取結束,JavaScript 引擎會把這個函式放進佇列並在空檔執行;此時檔案內容已就緒,所以在回呼內部存取 e.target.result 是安全的。
file.size 設上限。URL.createObjectURL(file) 產生 blob URL,用完務必呼叫 URL.revokeObjectURL() 釋放,否則記憶體不會回收。blob URL 的優點是不必把整個檔案轉成字串,效能明顯更好。file.type 與副檔名都由使用者端提供,可以被偽造。真正的型別與內容驗證必須在伺服器端進行,判斷依據應是實際的檔案標頭(magic number),而非檔名。