PC 端上傳文件用插件、甚至引入 Flash 都曾經很常見,但移動端如果還背著一堆冗余插件,用戶體驗會很糟。好在 HTML5 已經提供了完整的文件上傳接口,兼容性也已經不錯,沒有理由不用。
整個方案依賴三個 API:
<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" 則在支持的移動設備上直接喚起相機,這兩個屬性是移動端上傳體驗的關鍵。
(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
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 的這套接口已經足以替代絕大多數移動端上傳場景,不必再引入任何第三方庫。