DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
手機端 H5 圖片上傳實戰:Ajax + FormData + FileReader 完整範例
編輯:HTML5教程     

在 PC 網站上做檔案上傳,很多人第一反應就是找個外掛:Flash、各類 jQuery 上傳套件,甚至 ActiveX 都搬得上來。反正桌機環境相對單純,多載幾個依賴也不心疼。

但到了行動端,邏輯就完全反過來了。塞一堆老舊外掛進手機頁面,除了讓首屏變慢、相容性變差,使用者體驗也會直接被打壞。更別說 Flash 早已退出行動瀏覽器的歷史舞台。

所以當專案裡出現「使用者要能拍照/選圖片上傳」這種需求時,答案其實很清楚:HTML5 早就把這件事做成標準 API 了,而且在主流行動瀏覽器上的支援度相當不錯。既然原生能力就夠用,就沒有理由再繞遠路。

核心技術只有三個

  • Ajax / XMLHttpRequest:負責把資料送到伺服器,並且能回報上傳進度。
  • FormData:把 File 物件包裝成後端熟悉的 multipart 表單資料。
  • FileReader:把選到的檔案讀成 DataURL,用於上傳前的本機預覽。

三者搭配,就能在不刷新頁面的前提下,完成「選檔 → 預覽 → 帶進度上傳 → 接收回應」的整個流程。

HTML 結構

結構刻意做得很精簡:一個 input[type=file] 加上 capture="camera",行動裝置就會直接叫起相機;另外預留進度條與縮圖容器。

<div class="camera-area">
  <form enctype="multipart/form-data" method="post">
    <input type="file" name="fileToUpload" class="fileToUpload" accept="image/*" capture="camera"/>
    <div class="upload-progress"><span></span></div>
  </form>
  <div class="thumb"></div>
</div>

封裝成 Zepto 外掛:upload.js

把整個流程包成一個 fileUpload 方法,對外只暴露 url(上傳端點)與 file(表單欄位名稱)兩個參數,其他細節全部內聚。

(function($) {
  $.extend($.fn, {
    fileUpload: function(opts) {
      this.each(function() {
        var $self = $(this);
        var doms = {
          "fileToUpload": $self.find(".fileToUpload"),
          "thumb": $self.find(".thumb"),
          "progress": $self.find(".upload-progress")
        };

        var funs = {
          // 選擇檔案後先取得檔案清單與大小,這裡也是攔截格式/限制大小的最佳位置
          "fileSelected": function() {
            var files = doms.fileToUpload[0].files;
            var count = files.length;
            for (var index = 0; index < count; index++) {
              var file = files[index];
              var fileSize = 0;
              if (file.size > 1024 * 1024) {
                fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100).toString() + 'MB';
              } else {
                fileSize = (Math.round(file.size * 100 / 1024) / 100).toString() + 'KB';
              }
            }
            funs.uploadFile();
          },

          // 非同步上傳
          "uploadFile": function() {
            var fd = new FormData();              // 建立表單資料物件
            var files = doms.fileToUpload[0].files;
            var count = files.length;
            for (var index = 0; index < count; index++) {
              var file = files[index];
              fd.append(opts.file, file);         // 把檔案掛進表單資料
              funs.previewImage(file);            // 上傳前先本地預覽
            }

            var xhr = new XMLHttpRequest();
            xhr.upload.addEventListener("progress", funs.uploadProgress, false);
            xhr.addEventListener("load", funs.uploadComplete, false);
            xhr.addEventListener("error", opts.uploadFailed, false);
            xhr.open("POST", opts.url);
            xhr.send(fd);
          },

          // 以 FileReader 做本機預覽
          "previewImage": function(file) {
            var img = document.createElement("img");
            img.file = file;
            doms.thumb.html(img);

            var reader = new FileReader();
            reader.onload = (function(aImg) {
              return function(e) {
                aImg.src = e.target.result;
              };
            })(img);
            reader.readAsDataURL(file);
          },

          // 進度回報
          "uploadProgress": function(evt) {
            if (evt.lengthComputable) {
              var percentComplete = Math.round(evt.loaded * 100 / evt.total);
              doms.progress.find("span").width(percentComplete.toString() + '%');
            }
          },

          "uploadComplete": function(evt) {
            alert(evt.target.responseText);
          }
        };

        doms.fileToUpload.on("change", function() {
          doms.progress.find("span").width("0");
          funs.fileSelected();
        });
      });
    }
  });
})(Zepto);

呼叫方式

$(".camera-area").fileUpload({
  "url": "savetofile.php",
  "file": "myFile"
});

後端 PHP 端點

因為 FormData 送出的就是標準 multipart 內容,後端拿到的東西和一般表單上傳一模一樣,用 $_FILES 就能接到。

<?php
if (isset($_FILES['myFile'])) {
  writeLog($_FILES);
  move_uploaded_file($_FILES['myFile']['tmp_name'], "uploads/" . $_FILES['myFile']['name']);
  echo 'successful';
}

function writeLog($log) {
  if (is_array($log) || is_object($log)) {
    $log = json_encode($log);
  }
  $log = $log . "\r\n";
  file_put_contents('log.log', $log, FILE_APPEND);
}
?>

實作時值得留意的幾件事

  • 上傳前一定要在 fileSelected 階段把格式與大小檢查做完,不要等檔案傳完才發現使用者選錯。
  • accept="image/*" 只是提示,不是限制,真正的把關仍要在前端判斷加後端驗證一起做。
  • 後端存檔時別直接沿用使用者傳來的原檔名,重新產生一組名稱能避免覆寫與安全性風險。
  • 若要一次支援多選,替 input 加上 multiple 屬性即可,迴圈邏輯本身已經能吃多檔。

整套流程說穿了就是「用標準 API 取代外掛」,程式碼量不大,但省下的依賴與相容性成本相當可觀。

原文地址:https://www.cnblogs.com/hutuzhu/p/5254532.html

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved