傳統表單送出後必須整頁跳轉,體驗並不理想。搭配 jQuery 的 Ajax,我們可以在不離開頁面的情況下完成驗證、送出、回饋三件事。本文以一個聯絡我們表單為例,示範如何串接 jQuery 前端與 PHP 後端,並在成功後寄送 Email。
若對 jQuery 基本語法或 PHPMailer 用法不熟悉,建議先補上這兩塊基礎再往下閱讀。
<div id="contact_form">
<form name="contact" method="post" action="">
<fieldset>
<label for="name" id="name_label">姓名</label>
<input type="text" name="name" id="name" size="30" value="" class="text-input" />
<label class="error" for="name" id="name_error">此項必填</label>
<label for="email" id="email_label">您的 Email</label>
<input type="text" name="email" id="email" size="30" value="" class="text-input" />
<label class="error" for="email" id="email_error">此項必填</label>
<label for="phone" id="phone_label">您的聯絡電話</label>
<input type="text" name="phone" id="phone" size="30" value="" class="text-input" />
<label class="error" for="phone" id="phone_error">此項必填</label>
<br />
<input type="submit" name="submit" class="button" id="submit_btn" value="我要發送" />
</fieldset>
</form>
</div>
三個細節值得留意。第一,外層用 id="contact_form" 包住整份表單,稍後 Ajax 成功時要整塊替換內容會用到它。第二,form 標籤上雖然寫了 method 與 action,但因為實際送出是由 JavaScript 接管,這兩個屬性其實只是退化時的後備。第三,每個 input 都必須有獨立且唯一的 id,否則後續取值會出問題。
先確認 jQuery 主程式已經載入,然後另開一支 JS 檔:
$(function () {
$(".button").click(function () {
// 驗證與送出流程寫在這裡
});
});
第一行 $(function(){...}) 與 $(document).ready() 等價,都在 DOM 就緒後執行。第二行改用 click 事件攔截 class 為 button 的按鈕,藉此接管原本 submit 的行為——這正是 jQuery 能把結構與邏輯分離的地方。
$(function () {
$('.error').hide();
$(".button").click(function () {
$('.error').hide();
var name = $("input#name").val();
if (name == "") {
$("label#name_error").show();
$("input#name").focus();
return false;
}
var email = $("input#email").val();
if (email == "") {
$("label#email_error").show();
$("input#email").focus();
return false;
}
var phone = $("input#phone").val();
if (phone == "") {
$("label#phone_error").show();
$("input#phone").focus();
return false;
}
});
});
一開始先 $('.error').hide(),把所有錯誤提示藏起來;每次點擊時再重設一次,確保提示不會殘留。由於每個分支都 return false,所以一次只會顯示一個錯誤訊息,引導使用者逐項修正。
取值的方式在 jQuery 中非常直覺:
var name = $("input#name").val(); // 依 id 取值
var name = $(".name").eq(0).val(); // 依 class 取第一個
切記:每個必填欄位的驗證分支都要 return false,否則會出現「欄位還沒填完就送出去」的情況。
var dataString = 'name=' + name + '&email=' + email + '&phone=' + phone;
$.ajax({
type: "POST",
url: "bin/process.php",
data: dataString,
success: function () {
$('#contact_form').html("<div id='message'></div>");
$('#message').html("<h2>聯絡方式已成功提交!</h2>")
.append("<p>我們會盡快與您聯繫。</p>")
.hide()
.fadeIn(1500, function () {
$('#message').append("<img id='checkmark' src='images/check.png' />");
});
}
});
return false;
.ajax() 是整篇的核心:以 POST 把 dataString 異步送到 bin/process.php,成功後在頁面上呈現提示。最後的 return false 用來阻止表單的預設送出行為,避免頁面重新載入。
後端能做的事遠不只寄信。你可以把資料寫入資料庫、產生報名編號、寫入稽核log,再把結果回傳給前端顯示。
成功後,用 .html() 一行就把整個表單換成訊息區:
$('#contact_form').html("<div id='message'></div>");
接著用 .html() 填入內容、.append() 追加補充說明,最後以 hide() 搭配 fadeIn(1500) 做出淡入效果,並在動畫結束的 callback 裡補上一個成功圖示。這套「html → append → hide → fadeIn」的組合,可以說是 jQuery 做動態回饋的標準套路。
要落實到正式環境,通常還需要幾項補強:Email 格式與電話格式的正則驗證、送出過程中的 loading 動畫與重複點擊保護、以及後端的再次驗證(前端驗證只能算使用者體驗,不能當安全防線)。另外,下載的範例包裡有一支 runonload.js,作用僅是頁面載入時把游標聚焦到第一個輸入框,實際部署時記得改用自己的帳號密碼設定。