DIV CSS 佈局教程網

JavaScript File API 實作圖片「先預覽、後上傳」
編輯:關於JavaScript     

傳統上,瀏覽器應用要讀取本機檔案只能透過 <input type="file">。它的運作方式是:選檔時 value 屬性保存檔名,表單送出時瀏覽器把檔案內容送到伺服器,前端再拿伺服器回傳的網址做預覽。

問題是——如果使用者想換一張圖,就得再上傳一次才能看到新的預覽。網路慢一點,這個流程就非常折磨人。特別是有裁切需求時(例如更換大頭貼),必須先看到圖才能裁,這種往返完全沒有必要。

過去要做「先預覽」只能求助於 Flash 或瀏覽器專屬的額外元件,跨瀏覽器相容性是一場惡夢。File API 的出現讓這件事可以用純 JavaScript 解決。

一、取得使用者選取的檔案

監聽 file 輸入框的 change 事件,就能拿到 files 集合,其中每個 File 物件對應一個檔案,並提供四個唯讀屬性:name、size、type、lastModifiedDate。

有了這些資訊,格式、大小、檔名合法性都能在送出前先驗證,不必等後端回錯誤。

二、FileReader:異步讀取檔案內容

FileReader 提供一種異步讀取機制,概念上類似 XMLHttpRequest,差別在於它讀的是本機檔案系統而非遠端伺服器。它有四種讀取方法:

  • readAsText(file, encoding):以純文字形式讀取,結果存於 result 屬性,第二個參數可指定編碼。
  • readAsDataURL(file):讀為 data: URL 並存入 result。
  • readAsBinaryString(file):讀為二進位字串並存入 result。
  • readAsArrayBuffer(file):讀為 ArrayBuffer 並存入 result。

把同一張圖片分別以不同方法讀取,比對 result 的內容就能看出差異:

readAsText(file, encoding):

readAsDataURL(file):

不難看出,這些讀取模式為「靈活處理檔案資料」提供了極大的便利。例如把圖片讀成 data URL,就能直接拿來做上傳前的預覽。

由於讀取是異步的,FileReader 提供三個主要事件:progress(是否讀取了新資料)、error(是否發生錯誤)、load(是否已讀完整個檔案)。因故無法讀取時會觸發 error,錯誤碼位於 FileReader.error.code。

三、完整範例:預覽 + 格式與大小驗證

HTML:

<label class="item_label">上傳照片:
    <span style="width: 100px; height: 100px; border:1px solid #ccc; display:inline-block">
        <img src="#" id="uploadPreview" style="width: 100%; height: 100%;">
    </span>
    <input type="file" name="file" id="postFile" style="width:74px;">
    <span id="error_text" style="display: none;">提示</span>
</label>

JavaScript:

document.getElementById('postFile').onchange = function () {
    var val = this.value;
    var upLoadType = '.jpg,.gif,.bmp,.png';           // 允許的格式
    var fileExt = val.substr(val.lastIndexOf(".")).toLowerCase();
    var result = upLoadType.indexOf(fileExt);         // >=0 代表格式正確
    var _alertMsg = $('#error_text');
    var oFReader = new FileReader();

    if (this.files.length === 0) { return; }
    var oFile = this.files[0];

    if (oFile.size / 1024 < 100) {                    // 小於 100KB
        _alertMsg.html("<font style='color:blue'>√</font>").show();
    }

    if (result < 0) {
        _alertMsg.html("請輸入正確格式:" + upLoadType).show();
    } else {
        _alertMsg.html("<font style='color:blue'>√</font>").show();
    }

    oFReader.readAsDataURL(oFile);   // 後台開始讀取,完成後 data URL 傳入 onload

    oFReader.onload = function (oFREvent) {
        document.getElementById("uploadPreview").src = oFREvent.target.result;
    };
};

成果與回傳的圖片 URL:

四、幾個實務上的改良建議

用 type 屬性取代副檔名判斷。file.type 直接給出 MIME 類型,比從檔名擷取副檔名可靠;同時搭配 accept="image/*" 限制檔案選擇器顯示範圍。

記得處理 error 事件。範例只監聽了 load,實務上應一併綁定 onerror,對使用者說明失敗原因。

釋放 Object URL。若改用 URL.createObjectURL(file) 取代 data URL(大檔效能差異明顯),在更換或移除圖片時要呼叫 URL.revokeObjectURL(),否則記憶體不會釋放。

前端驗證只是第一道防線。格式與大小檢查在伺服器端仍須再做一次,並以隨機名稱存檔,避免使用者偽造檔名造成風險。

真正上傳時,用 FormData 搭配 fetch 或 XMLHttpRequest 即可,不必自己拼 multipart:

var fd = new FormData();
fd.append("file", document.getElementById('postFile').files[0]);
fetch("/upload", { method: "POST", body: fd });
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved