jQuery 對 AJAX 的支援相當完整,從最底層的 $.ajax() 到最直覺的 load(),幾乎涵蓋所有常見情境。
$.ajax() 是最基本也最通用的入口,靠不同的參數組合就能應付各種需求。最簡短的寫法大概像這樣:
$.ajax({
url: "test.html",
cache: false,
success: function (html) {
$("#results").append(html);
}
});
參數的完整清單可參考官方 options 文件。實務上最常派上用場的其實是這幾個:
先寫一個 CubeHandler.ashx 當作 AJAX 的服務端。因為使用 Request.Params 取值,所以 GET 與 POST 兩種送法都吃:
<%@ WebHandler Language="C#" Class="CubeHandler" %>
using System;
using System.Web;
public class CubeHandler : IHttpHandler {
public void ProcessRequest(HttpContext context) {
context.Response.ContentType = "text/plain";
int number = 0;
int.TryParse(context.Request.Params["number"], out number);
context.Response.StatusCode = 200;
context.Response.Cache.SetCacheability(HttpCacheability.NoCache);
context.Response.Write(string.Format("{0} cubed is {1}",
number, Math.Pow(number, 3)));
}
public bool IsReusable { get { return true; } }
}
前端則先用 ajaxStart / ajaxSuccess / ajaxError 把指示器統一管起來,再分別綁上 GET 與 POST 兩個按鈕:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>AJAX</title>
<script src="../scripts/jquery-1.2.3.intellisense.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
// 全域指示器
$('#divIndicator')
.ajaxStart(function () { $(this).show(); })
.ajaxSuccess(function () { $(this).hide(); })
.ajaxError(function (msg) { $(this).hide(); alert(msg); });
// AJAX GET
$('#btnGetCubeInGet').click(function () {
var number = $('#txtNumber').val();
$.get('CubeHandler.ashx?number=' + number, function (result) {
alert(result);
});
});
// AJAX POST
$('#btnGetCubeInPost').click(function () {
var number = $('#txtNumber').val();
$.post('CubeHandler.ashx', { 'number': number }, function (result) {
alert(result);
});
});
});
</script>
<style type="text/css">
.indicator {
color: #FF0000;
position: absolute;
top: 0px;
right: 0px;
display: none;
}
</style>
</head>
<body>
<div id="divIndicator" class="indicator">
<img src="indicator.gif" alt="loading" />loading<img src="https://divcss.yunyiwangluo.com/divcssbuju/UploadFiles_7251/201612/2016123017531186.gif" /></div>
plz input a number: <input id="txtNumber" type="text" />
<input type="button" id="btnGetCubeInGet" value="Get cube(get)" />
<input type="button" id="btnGetCubeInPost" value="Get cube(post)" />
</body>
</html>
全域事件的好處在於不必每個請求都重複寫一次 loading 邏輯,指示器會自動隨請求開始而顯示、結束而隱藏。這也是為什麼 ajaxStart 這類方法值得優先掌握。