還在為原生 JavaScript 裡那一大串 XMLHttpRequest 而頭疼嗎?自從改用 jQuery,AJAX 這件事幾乎變成「填幾個參數就搞定」。本文整理 jQuery 提交表單資料的兩條主要路線:一是把資料拼進 URL 查詢字串,二是直接以整份 Form 表單送出,讓後端照舊用熟悉的表單取值方式接收。
如果表單欄位多達十幾個,第一種做法意味著你要一個一個手動取值、組字串,既冗長又容易漏。第二種則可以借助 jquery.form 外掛一次打包送出,後端完全不需要改寫取值邏輯。除非只是想練手,否則欄位一多就該選第二種。
請先下載並引入兩個檔案:jquery.js 與 jquery.form.js,官網與各大資源站都能找到。
核心概念是把單一欄位的值塞進 data 屬性,效果等同於請求 CheckCorpID.ashx?ID=XXX。下面的例子示範「客戶編號是否可用」的即時檢測:
<script type="text/javascript" src="../js/jquery.js"></script>
<script type="text/javascript">
function checkCorpID() { // 檢測客戶編號是否可用
if ($.trim($("#txtF_CORPID")[0].value) == "") { // txtF_CORPID 為客戶編號輸入框
alert("請輸入客戶編號!");
} else {
$("#checkFlag").html("正在檢測"); // 顯示提示訊息
$.ajax({
type: "get",
url: "CheckCorpID.ashx",
data: "ID=" + $.trim($("#txtF_CORPID")[0].value), // 等同 CheckCorpID.ashx?ID=XXX
success: function (msg) { // msg 為後端回傳的字串
$("#checkFlag").html("");
alert(msg);
}
});
}
}
</script>
後端(ashx 泛型處理常式)只要照一般方式取參數即可:
if (context.Request.Params["ID"].ToString() != "")
{
Pxt.Logic.SYS.CORP_BASE_INFO cbiL = new Pxt.Logic.SYS.CORP_BASE_INFO();
bool flag = cbiL.checkCorpID(context.Request.Params["ID"].ToString());
if (flag)
context.Response.Write("該客戶編號已被佔用!");
else
context.Response.Write("該客戶編號可用!");
}
這個方式需要 jquery.form 外掛,關鍵在 ajaxSubmit() 與 return false:前者負責把整份表單序列化送出,後者阻止瀏覽器執行預設的實體提交,避免頁面刷新。
<script type="text/javascript" src="../js/jquery.js"></script>
<script type="text/javascript" src="../js/jquery.form.js"></script>
<script type="text/javascript">
$(document).ready(function () {
$('#Tip').hide(); // 先隱藏操作提示元素
$('#form1').submit(function () {
var options = {
target: '#Tip', // 後端回傳值會填入此元素
url: 'ReturnVisit.aspx?flag=do', // 提交目標
type: 'POST',
success: function () { alert($('#Tip').text()); }
};
$('#form1').ajaxSubmit(options);
return false; // 不刷新頁面
});
});
</script>
<body>
<form id="form1" runat="server">
<table width="100%" border="0" align="center" cellpadding="0" cellspacing="0">
<tr><td colspan="2" class="tableCategory">客戶回訪</td></tr>
<tr><td class="tableBg1">客戶名稱:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_CorpName" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">回訪主題:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ReturnVisitTitle" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">聯絡人:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ContractPerson" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">聯絡人職務:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ContractPersonPosition" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">聯絡電話:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ContractPhone" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">回訪時間:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ReturnVisitDate" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">回訪內容:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ReturnVisitContent" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1">回訪相關文檔:</td>
<td class="tableBg2"><asp:TextBox ID="txtF_ReturnVisitFile" runat="server"></asp:TextBox></td></tr>
<tr><td class="tableBg1"></td>
<td class="tableBg2">
<asp:Button ID="Submit_BT" runat="server" Text="確定" CssClass="button" />
<input type="reset" class="button" value="還原" />
</td></tr>
</table>
<span id="Tip"></span>
</form>
</body>
後端在 Page_Load 中判斷旗標,再用 Request.Form[...] 取值組裝模型,這部分與傳統 PostBack 幾乎一致:
protected void Page_Load(object sender, EventArgs e)
{
if (Request.QueryString["flag"] != null && Request.QueryString["flag"].ToString() == "do")
{
Pxt.Logic.DBRec.ReturnVisit bll = new Pxt.Logic.DBRec.ReturnVisit();
if (bll.Add(model(0)) > 0)
{
Response.Write("操作成功!");
Response.End();
}
}
}
private Pxt.Model.DBRec.ReturnVisit model(int id)
{
// 以 Request.Form 取值,與一般表單完全相同
string F_CorpName = Request.Form["txtF_CorpName"].ToString();
string F_ReturnVisitTitle = Request.Form["txtF_ReturnVisitTitle"].ToString();
string F_ContractPerson = Request.Form["txtF_ContractPerson"].ToString();
string F_ContractPersonPosition = Request.Form["txtF_ContractPersonPosition"].ToString();
string F_ContractPhone = Request.Form["txtF_ContractPhone"].ToString();
DateTime F_ReturnVisitDate = DateTime.Parse(Request.Form["txtF_ReturnVisitDate"].ToString());
string F_ReturnVisitContent = Request.Form["txtF_ReturnVisitContent"].ToString();
string F_ReturnVisitFile = Request.Form["txtF_ReturnVisitFile"].ToString();
string Refer = Session["username"].ToString();
DateTime DoTime = DateTime.Now.Date;
Pxt.Model.DBRec.ReturnVisit model = new Pxt.Model.DBRec.ReturnVisit();
if (id > 0) model.ID = id; // 有 id 代表修改,否則為新增
model.F_CorpName = F_CorpName;
model.F_ReturnVisitTitle = F_ReturnVisitTitle;
model.F_ContractPerson = F_ContractPerson;
model.F_ContractPersonPosition = F_ContractPersonPosition;
model.F_ContractPhone = F_ContractPhone;
model.F_ReturnVisitDate = F_ReturnVisitDate;
model.F_ReturnVisitContent = F_ReturnVisitContent;
model.F_ReturnVisitFile = F_ReturnVisitFile;
model.Refer = Refer;
model.DoTime = DoTime;
return model;
}
欄位少、只需回傳單一狀態(例如「此帳號是否可用」)時,URL 參數法最直觀;欄位多、需要整批送出並沿用既有後端邏輯時,ajaxSubmit 才是省事的做法。另外提醒:jquery.form 是專門輔助表單操作的外掛,寫法與選項還不少,建議搭配官方教學一起看。