傳統表單提交一定會帶走頁面,使用體驗總是打斷的。而 HTML5 帶來的 FormData 物件,讓這件事變得意外簡單:一行程式就能把整個表單(包含檔案欄位)打包好,直接交給 XMLHttpRequest 送出。
流程只有三步:
new FormData(fm) 實例化,它就會自動收集 fm 底下所有表單域,包含一般欄位與上傳檔案。var fd = new FormData(fm); // 實例化,fd 內部已含所有表單域資訊
這裡額外示範了 xhr.upload.onprogress 的用法,可以即時得知檔案上傳的百分比,並用它驅動一個簡單的進度條。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<script type="text/javascript">
window.onload = function(){
var fm = document.getElementsByTagName('form')[0];
fm.onsubmit = function(){
//利用 FormData 收集表單資訊
var fd = new FormData(fm);
//fd 內部會把普通表單域與上傳檔案域一併收集
var xhr = new XMLHttpRequest();
xhr.onreadystatechange = function(){
if(xhr.readyState == 4){
alert(xhr.responseText);
}
}
//監聽上傳進度
xhr.upload.onprogress = function(evt){
var loaded = evt.loaded;
var total = evt.total;
var per = Math.floor((loaded/total)*100) + "%";
document.getElementById('son').innerHTML = per;
document.getElementById('son').style.width = per;
}
xhr.open('post','./05.php');
xhr.send(fd);
return false;//阻止瀏覽器預設提交
}
}
</script>
<style type="text/css">
#pat {width:430px;height:40px; border:5px solid blue;}
#son {width:0;height:100%; background-color:lightblue;}
</style>
</head>
<body>
<h2>ajax + FormData 實現無刷新檔案上傳</h2>
<form method="post" action="">
<p>用戶名:<input type="text" name="username" /></p>
<p>密碼:<input type="password" name="password" /></p>
<p>郵箱:<input type="text" name="email" /></p>
<div id="pat"><div id="son"></div></div>
<p>頭像:<input type="file" name="user_pic" /></p>
<p><input type="submit" value="注冊" /></p>
</form>
</body>
</html>
要注意 return false 這一行不能省。少了它,瀏覽器還是會照原樣送出表單並跳頁,前面寫的 Ajax 就白做了。
整體流程是:本地檔案 →(上傳)→ PHP 處理 → 伺服器。這裡有個容易被忽略的編碼問題:本地檔名的編碼是 gb2312,而 PHP 程式的編碼是 UTF-8,伺服器端存的又是 gb2312。所以必須在程式裡把 UTF-8 的檔名轉碼成 GB2312,否則中文檔名會變成亂碼。
<?php
//$_FILES['user_pic']['error']
//0 -> ok
//1 -> 大小超過 php.ini 限制
//2 -> 大小超過 MAX_FILE_SIZE 限制
//3 -> 附件只上傳了一部分(不完整)
//4 -> 沒有上傳附件
if($_FILES['user_pic']['error'] > 0){
exit('上傳附件有問題,有可能沒有附件');
}
$name = $_FILES['user_pic']['name'];
$name = iconv('UTF-8','GB2312',$name); //檔名編碼由 UTF-8 轉為 GB2312
$path = "./upload/";
//附件上傳邏輯
//move_uploaded_file(臨時路徑名, 真實路徑名);
if(move_uploaded_file($_FILES['user_pic']['tmp_name'], $path.$name))
echo "success";
else
echo "fail";
$_FILES[...]['error'] 的狀態碼很值得背起來:0 代表成功,1 是超出 php.ini 上限,2 是超出表單設定的 MAX_FILE_SIZE,3 表示只傳了一部分,4 則是使用者根本沒選檔案。先做這層檢查,後續邏輯才不會在髒資料上運行。
如果你已經在用 jQuery,也有更短的路。做法是先用 serializeArray() 把表單轉為鍵值對,再交給 $.ajax:
//將 form 轉為 AJAX 提交
function ajaxSubmit(url, frm, fn){
var dataPara = getFormJson(frm);
$.ajax({
url: url,
type: "post",
data: dataPara,
async: false,
dataType: 'txt',
success: fn
});
}
//將 form 中的值轉為鍵值對
function getFormJson(frm){
var o = {};
var a = $(frm).serializeArray();
$.each(a, function(){
if(o[this.name] !== undefined){
if(!o[this.name].push){
o[this.name] = [o[this.name]];
}
o[this.name].push(this.value || '');
}else{
o[this.name] = this.value || '';
}
});
return o;
}
//前台呼叫方式
// function autoSubmitFun(){
// ajaxSubmit("autoSumitScoreAJAX.action", $('#formId'), function(){});
// }
這裡那段 if(!o[this.name].push) 的判斷是在處理同名欄位:第一次遇到時先存成字串,第二次遇到時把它推入陣列,之後再持續 append。少了這段,多選或同名的 checkbox 就會互相覆蓋。
FormData 的原生方案更適合有檔案上傳需求的場景,因為它天生就支援 multipart,還能搭配 upload.onprogress 做進度回饋。jQuery 的 serializeArray 方案寫起來快,但不含檔案欄位,只適合純文字表單。選哪一個,取決於你的表單裡有沒有 <input type="file">。