DIV CSS 佈局教程網

HTML5 移動端文件上傳:ajax + FileReader + FormData 三件套
編輯:關於JavaScript     

PC 端上傳文件用插件、甚至引入 Flash 都曾經很常見,但移動端如果還背著一堆冗余插件,用戶體驗會很糟。好在 HTML5 已經提供了完整的文件上傳接口,兼容性也已經不錯,沒有理由不用。

整個方案依賴三個 API:

  • FormData:構造表單數據,可以直接裝 File 對象
  • FileReader:讀取本地文件內容,用來做上傳前預覽
  • XMLHttpRequest:發送異步請求,並通過 upload.onprogress 回報進度

HTML 結構

<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>

accept="image/*" 限制只能選圖片,capture="camera" 則在支持的移動設備上直接喚起相機,這兩個屬性是移動端上傳體驗的關鍵。

封裝好的 upload.js(依賴 Zepto)

(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';
                            }
                            console.log(file.name, fileSize);
                        }
                        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 讀成 DataURL 賦給 img.src
                    previewImage: function (file) {
                        var gallery = doms.thumb;
                        var img = document.createElement("img");
                        img.file = file;
                        gallery.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.html(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)

<?php
if (isset($_FILES['myFile'])) {
    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);
    }
    file_put_contents('log.log', $log . "\r\n", FILE_APPEND);
}
?>

幾個實踐要點

FileReader 的閉包陷阱。預覽函數裡之所以要寫 (function(aImg){ return function(e){...} })(img),是為了避免迴圈中 img 變量被後續迭代覆蓋。如果改成 let 聲明,可以直接寫 img.onload = e => img.src = e.target.result,不必繞這一圈。

服務端必須做校驗。示例直接用了 $_FILES['myFile']['name'] 拼接路徑,這存在路徑穿越與任意文件上傳風險。生產環境至少要做三件事:校驗 MIME 與真實文件頭、用自定義文件名(如 UUID)而非用戶上傳的原名、把文件存到 Web 根目錄之外或禁止腳本執行。

進度條要綁在 upload 對象上。xhr.upload.addEventListener("progress", ...) 才是上傳進度;綁在 xhr 上的 progress 是下載進度,上傳時根本不會觸發。

大文件需要分片。FormData 整體上傳適合圖片這類小文件。若帶寬有限或文件較大,應改用 file.slice 配合分片上傳與斷點續傳。

總體來說,HTML5 的這套接口已經足以替代絕大多數移動端上傳場景,不必再引入任何第三方庫。

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