前幾天在寫後台管理頁面時遇到一個小問題:需要上傳一張圖片,於是用了最傳統的 Form 表單,把一段 JSON 字串與圖片檔一起送出。
傳統做法要在 <form> 標籤上加上 enctype="multipart/form-data",圖片確實能上傳成功。但問題來了:表單一送出,瀏覽器直接跳到顯示回傳內容的頁面,原本的頁面也被刷新掉了——使用者填的內容、當前的操作狀態全部消失。
這時候就需要 Ajax 來做局部更新。以下是完整實作。
<form id="form_insert" method="post">
<table style="font-size: 13px; margin: 13px auto;">
<tr>
<td style="text-align: right;">類型</td>
<td>: <input id="acttype" style="width:150px" class="easyui-textbox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">名稱</td>
<td>: <input id="actname" style="width:150px" class="easyui-textbox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">開始時間</td>
<td>: <input id="actstarttime" style="width:150px" class="easyui-datetimebox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">結束時間</td>
<td>: <input id="actendtime" style="width:150px" class="easyui-datetimebox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">省</td>
<td>: <input id="mem_Province" style="width:150px" class="easyui-combobox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">市</td>
<td>: <input id="mem_City" style="width:150px" class="easyui-combobox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">門店</td>
<td>: <input id="mem_Shop" style="width:150px" class="easyui-combobox" data-options="required:true"></td>
</tr>
<tr><td colspan="2" style="height: 13px"></td></tr>
<tr>
<td style="text-align: right;">具體地址</td>
<td>: <input id="actadd" style="width:150px" class="easyui-textbox" data-options="required:true"></td>
</tr>
</table>
</form>
<form id="form_sub" style="font-size: 13px;">
<table style="font-size: 13px; margin: 13px auto;">
<tr>
<td style="text-align: right;">上傳圖片</td>
<td>: <input class="easyui-filebox" name="photo" style="width:153px"
data-options="required:true,prompt:'選擇上傳圖片',buttonText:' 選 擇 '"></td>
<td><input type="text" id="Item" name="item" style="display:none;"></td>
</tr>
</table>
</form>
<div style="text-align:right; padding:2px 5px;">
<a id="sub" class="easyui-linkbutton" data-options="iconCls:'icon-ok'" href="javascript:void(0)">保存</a>
<a class="easyui-linkbutton" data-options="iconCls:'icon-quxiao'" href="javascript:void(0)"
onclick="window_open($('#insert_form'), 'close')">取消</a>
</div>
說到這裡,可能有朋友想問:為什麼要寫兩個 form?
因為後端接收資料的方式是「一段字串 + 一個檔案」。於是我先把第一個表單的內容用 JS 收集起來、轉成字串,塞進第二個表單裡那個 style="display:none" 的隱藏欄位,然後用 Ajax 把第二個表單整體送出。
$('#sub').click(function () {
var actTimeStart1 = $('#actstarttime').datebox('getValue');
var actTimeStart = changeDateToLong(actTimeStart1);
var actTimeEnd1 = $('#actendtime').datebox('getValue');
var actTimeEnd = changeDateToLong(actTimeEnd1);
if (actTimeStart != '' && actTimeEnd != '' && (actTimeStart - actTimeEnd > 0)) {
$.messager.alert('警告', '結束時間不能小於開始時間!', 'error');
return false;
} else {
if ($('#form_insert').form('validate')) {
var jsonObj = {
actType: document.getElementById("acttype").value,
actName: document.getElementById("actname").value,
actTimeStart: actTimeStart,
actTimeEnd: actTimeEnd,
actArea: document.getElementById("actadd").value,
t2: $('#mem_Shop').combobox('getValue')
};
var activityMemberJson = JSON.stringify(jsonObj);
// 把字串放進隱藏欄位,一起送出
document.getElementById("Item").value = activityMemberJson;
var form = new FormData(document.getElementById("form_sub"));
$.ajax({
url: '../activity/actionActivityInsert',
type: "post",
data: form,
processData: false, // 不要把 data 轉成查詢字串
contentType: false, // 讓瀏覽器自行帶上含 boundary 的標頭
error: function (request) { },
success: function (data) {
$('#box').datagrid('reload');
}
});
window_open($('#insert_form'), 'close');
} else {
$.messager.alert('警告', '信息不完整!', 'error');
}
}
});
FormData 是 HTML5 帶來的利器。把表單元素傳進建構子,它就會自動把 file 類型的欄位打包成 multipart,完全不必手動設定 enctype。
但用 FormData 搭配 jQuery Ajax 時,processData: false 與 contentType: false 這兩行是必要的。前者避免 jQuery 把 FormData 轉成字串(轉了檔案就沒了);後者避免 jQuery 硬塞 application/x-www-form-urlencoded——含 boundary 的 multipart 標頭必須由瀏覽器依實際內容自動產生,自己寫反而會錯。
順帶修正範例中的一個邏輯問題:判斷式寫成 actTimeStart - actTimeEnd > 0 意思是「開始晚於結束」,訊息文字卻寫「結束時間不能小於開始時間」。兩者語意相反,實際上你要的應該是 actTimeEnd < actTimeStart 時報錯。這類條件與提示文案不一致的 bug 很常見,值得多看一眼。
另外,把 JSON 字串塞進隱藏欄位是個可行的權宜之計,但如果你能改用 FormData 的 append() 直接附加各個欄位,就不需要多這道手續,後端也能用 regular form 參數接收,不必再解析字串。