在 PC 網站上做檔案上傳,很多人第一反應就是找個外掛:Flash、各類 jQuery 上傳套件,甚至 ActiveX 都搬得上來。反正桌機環境相對單純,多載幾個依賴也不心疼。
但到了行動端,邏輯就完全反過來了。塞一堆老舊外掛進手機頁面,除了讓首屏變慢、相容性變差,使用者體驗也會直接被打壞。更別說 Flash 早已退出行動瀏覽器的歷史舞台。
所以當專案裡出現「使用者要能拍照/選圖片上傳」這種需求時,答案其實很清楚:HTML5 早就把這件事做成標準 API 了,而且在主流行動瀏覽器上的支援度相當不錯。既然原生能力就夠用,就沒有理由再繞遠路。
三者搭配,就能在不刷新頁面的前提下,完成「選檔 → 預覽 → 帶進度上傳 → 接收回應」的整個流程。
結構刻意做得很精簡:一個 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>
把整個流程包成一個 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"
});
因為 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/*" 只是提示,不是限制,真正的把關仍要在前端判斷加後端驗證一起做。multiple 屬性即可,迴圈邏輯本身已經能吃多檔。整套流程說穿了就是「用標準 API 取代外掛」,程式碼量不大,但省下的依賴與相容性成本相當可觀。
原文地址:https://www.cnblogs.com/hutuzhu/p/5254532.html