萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML5 圖片預覽實作指南:URL.createObjectURL 與 FileReader 完整教學

在 Web 開發中,讓使用者上傳圖片前即時預覽是常見需求。HTML5 提供了兩種核心 API 來達成此功能:URL.createObjectURL() 與 FileReader。本文將詳細解析兩者的運作原理、程式碼實作與優缺點比較,助你快速整合圖片預覽功能。

核心方法比較

方法運作機制優點缺點
URL.createObjectURL() 建立指向 File 或 Blob 物件的暫時 URL,瀏覽器可直接當作圖片來源載入。 速度極快、不需讀取檔案內容、記憶體佔用低。 URL 僅在文件存活期間有效,需手動呼叫 revokeObjectURL() 釋放記憶體。
FileReader.readAsDataURL() 將檔案讀取為 Base64 編碼的 Data URL,直接嵌入 src 屬性。 相容性極佳、可直接儲存或傳輸字串。 大檔案轉換較慢、Base64 體積約增加 33%、佔用較多記憶體。

完整程式碼範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>HTML5 圖片上傳預覽</title>
  <style>
    #preview { width: 300px; height: 300px; overflow: hidden; border: 1px solid #ddd; }
    #preview img { width: 100%; height: 100%; object-fit: cover; }
  </style>
</head>
<body>
  <input type="file" accept="image/*" id="fileInput">
  <div id="preview"></div>

  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
  <script>
    // 方法一:URL.createObjectURL
    function previewWithURL(file) {
      const url = URL.createObjectURL(file);
      const $img = $('<img>').attr('src', url);
      $img.on('load', function() {
        URL.revokeObjectURL(url); // 釋放記憶體
        $('#preview').empty().append($img);
      });
    }

    // 方法二:FileReader
    function previewWithFileReader(file) {
      const reader = new FileReader();
      reader.onload = function(e) {
        const $img = $('<img>').attr('src', e.target.result);
        $('#preview').empty().append($img);
      };
      reader.readAsDataURL(file);
    }

    // 綁定事件
    $(function() {
      $('#fileInput').on('change', function(e) {
        const file = e.target.files[0];
        if (!file || !file.type.startsWith('image/')) return;
        // 這裡示範使用 URL 方法,實際專案可依需求切換
        previewWithURL(file);
      });
    });
  </script>
</body>
</html>

關鍵細節說明

  • 記憶體管理:使用 URL.createObjectURL() 時,務必在圖片載入完成後呼叫 URL.revokeObjectURL(),避免記憶體洩漏。
  • 檔案驗證:建議在預覽前檢查 file.type 確認為圖片格式,並可限制檔案大小。
  • 多檔支援:若需多圖預覽,可迭代 e.target.files 陣列,動態建立多個預覽區塊。
  • 相容性:兩種 API 在現代瀏覽器(含 IE10+)均完整支援,舊版 IE 需用 Flash 或伺服器端預覽替代。

實務建議

一般情況下,優先使用 URL.createObjectURL(),因其效能優異、不阻塞主執行緒。僅當需要將圖片轉為 Base64 字串儲存(如離線快取、直接送入 Canvas 處理)時,才改用 FileReader。結合兩者優點,可打造流暢、穩定的圖片上傳體驗。

copyright © 萬盛學電腦網 all rights reserved