DIV CSS 佈局教程網

Ajax 送出表單與檔案上傳:用 FormData 同時帶上文字與圖片
編輯:AJAX基礎知識     

前幾天在寫後台管理頁面時遇到一個小問題:需要上傳一張圖片,於是用了最傳統的 Form 表單,把一段 JSON 字串與圖片檔一起送出。

傳統做法要在 <form> 標籤上加上 enctype="multipart/form-data",圖片確實能上傳成功。但問題來了:表單一送出,瀏覽器直接跳到顯示回傳內容的頁面,原本的頁面也被刷新掉了——使用者填的內容、當前的操作狀態全部消失。

這時候就需要 Ajax 來做局部更新。以下是完整實作。

HTML

<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 把第二個表單整體送出。

JavaScript

$('#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 參數接收,不必再解析字串。

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