AJAX 最經典的入門案例就是「輸入時即時檢查帳號是否可用」。這個例子同時示範了前端取事件、發請求、接收回應三個動作,以及後端該怎麼配合。
因為資料是以 AJAX 送出而非表單提交,所以不必包 form:
<!DOCTYPE html>
<html>
<head>
<title>用戶名校驗實例</title>
<script src="../js/jquery.min.js" type="text/javascript"></script>
<script src="../js/verify.js" type="text/javascript"></script>
</head>
<body onload="verify()">
<p>用戶名校驗的 AJAX 實例</p>
<input type="text" id="userName" />
<div id="result"></div>
</body>
</html>
#result 這個 div 是預留的結果顯示區。
function verify() {
$("#userName").keyup(function () {
var user = $(this).val();
$.post("../index.aspx", { userobj: user }, callback);
});
}
function callback(data) {
$("#result").text(data);
}
$.post() 的第三個參數是成功後要呼叫的函式,回應內容會作為第一個參數傳入。
<%
Response.Clear();
string str_name = Request["userobj"];
if (str_name == "xtyang") {
Response.Write("ok");
} else {
Response.Write("no");
}
Response.End();
%>
Response.Clear() 是必要的,否則頁面殘留的空白或 BOM 會混進回應裡,讓前端的比對失效。
一、每次按鍵都發一次請求。快速輸入「xtyang」六個字,就會送出六個請求,其中五個是白費的。加個 debounce 就能省下大量無效往返:
var timer;
$("#userName").keyup(function () {
var user = $(this).val();
clearTimeout(timer);
timer = setTimeout(function () {
$.post("../index.aspx", { userobj: user }, callback);
}, 300);
});
二、回應可能「搶答」。先送出的請求不一定先返回,使用者可能看到舊請求的結果覆蓋新結果。解法是在 callback 裡比對目前的輸入值:
function callback(data) {
if ($("#userName").val() === sentValue) {
$("#result").text(data);
}
}
三、用 text 而非 html 是對的,但要留意 XSS。範例用了 .text(),會自動轉義,這是安全的。如果哪天改成 .html() 並把後端回應直接塞進去,就等於替攻擊者開了一扇門。另外,前端驗證只是使用者體驗,真正的唯一性檢查一定要在伺服器端提交時再做一次——繞過前端對任何人都不難。
用 Promise 風格取代回呼,並加上錯誤處理:
$.post("../index.aspx", { userobj: user })
.done(function (data) { $("#result").text(data); })
.fail(function () { $("#result").text("檢查失敗,請稍後再試"); });
若要回傳結構化資料,把後端改成輸出 JSON、前端指定 dataType: 'json',就能用欄位區分「可用」「已被使用」「格式不合法」等狀態,而不必靠比對字串。