透過 jQuery 內建的 AJAX 功能向後端取得 JSON 資料,再把資料填進預先寫好的 HTML 模板裡渲染到畫面上,是早期非常常見的一種做法。整個過程可以拆成三塊:模板、請求、綁定。
這裡用一個表格當容器,其中 id="template" 的那一列就是「樣板列」,稍後會被複製很多次:
<table id="datas" border="1" cellspacing="0" style="border-collapse: collapse"> <tr> <th>訂單ID</th><th>客戶ID</th><th>雇員ID</th> <th>訂購日期</th><th>發貨日期</th><th>貨主名稱</th> <th>貨主地址</th><th>貨主城市</th><th>更多信息</th> </tr> <tr id="template"> <td id="OrderID"></td><td id="CustomerID"></td><td id="EmployeeID"></td> <td id="OrderDate"></td><td id="ShippedDate"></td> <td id="ShippedName"></td><td id="ShippedAddress"></td> <td id="ShippedCity"></td><td id="more"></td> </tr> </table>
這裡最關鍵的就是每一格 td 的 id。資料能不能正確落到對應位置,完全取決於這些 id 有沒有對上。
$.ajax({
type: "get", // 使用 get 存取後端
dataType: "json", // 宣告回傳格式為 JSON
url: "BackHandler.ashx", // 後端位址
data: "pageIndex=" + pageIndex, // 送出的參數
complete: function () { $("#load").hide(); }, // 請求結束後隱藏 loading
success: function (msg) {
var data = msg.table;
$.each(data, function (i, n) {
var row = $("#template").clone();
row.find("#OrderID").text(n.訂單ID);
row.find("#CustomerID").text(n.客戶ID);
row.find("#EmployeeID").text(n.雇員ID);
row.find("#OrderDate").text(ChangeDate(n.訂購日期));
if (n.發貨日期 !== undefined) {
row.find("#ShippedDate").text(ChangeDate(n.發貨日期));
}
row.find("#ShippedName").text(n.貨主名稱);
row.find("#ShippedAddress").text(n.貨主地址);
row.find("#ShippedCity").text(n.貨主城市);
row.find("#more").html("<a href=OrderInfo.aspx?id=" + n.訂單ID + "&pageindex=" + pageIndex + ">More</a>");
row.attr("id", "ready"); // 換掉 id,避免重複
row.appendTo("#datas"); // 掛到容器上
});
}
});
回傳的資料結構並不複雜,重點在於「怎麼照模板的定義把資料放到頁面上」:
var row = $("#template").clone(); 先把樣板複製一份。row.find("#OrderID").text(n.訂單ID); 找到 id 為 OrderID 的元素,把它的文字設為對應欄位;想塞 HTML 就改用 .html()。ChangeDate(n.訂購日期),整體寫起來有幾分像伺服器端控制項做資料綁定的感覺。整個頁面是靜態的,不需要 form,只靠 AJAX 抓資料:
<!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>test1</title> <script type="text/javascript" src="js/jquery-latest.pack.js"></script> <script type="text/javascript" src="js/PageDate.js"></script> </head> <body> <div> <div> <input id="first" type="button" value=" << " /> <input id="previous" type="button" value=" < " /> <input id="next" type="button" value=" > " /> <input id="last" type="button" value=" >> " /> <span id="pageinfo"></span> <table id="datas" border="1" cellspacing="0" style="border-collapse: collapse"> <tr><th>訂單ID</th><th>客戶ID</th><th>雇員ID</th><th>訂購日期</th><th>發貨日期</th><th>貨主名稱</th><th>貨主地址</th><th>貨主城市</th><th>更多信息</th></tr> <tr id="template"> <td id="OrderID"></td><td id="CustomerID"></td><td id="EmployeeID"></td> <td id="OrderDate"></td><td id="ShippedDate"></td> <td id="ShippedName"></td><td id="ShippedAddress"></td> <td id="ShippedCity"></td><td id="more"></td> </tr> </table> </div> <div id="load" style="position: absolute; top: 0; left: 0; background-color: red">LOADING....</div> <input type="hidden" id="pagecount" /> </div> </body> </html>
PageData.js 裡放的就是上面那段 AJAX 請求與綁定的程式。
如果換成另一種表現形式,例如改成無序清單:
<ul id="datas"> <li id="template"> <span id="OrderID"></span><span id="CustomerID"></span> <span id="EmployeeID"></span><span id="OrderDate"></span> <span id="ShippedDate"></span><span id="ShippedName"></span> <span id="ShippedAddress"></span><span id="ShippedCity"></span> <span id="more"></span> </li> </ul>
標籤從 table 換成 ul/li,但 id 沒變,JavaScript 一行都不用改。這代表只要 id 約定好,美術或前端可以自由更換版面結構,後端工程師不必跟著改程式,美工也只需要交出 HTML,不必為了伺服器控制項去學模板語法。
範例的後端使用 Access 的 Northwind 資料庫,把訂單表讀進 DataTable,再透過 DataTable2JSON 轉成 JSON 字串回傳,中間另外加了分頁與快取處理。對初學者來說,把「取資料 → 轉格式 → 回傳」這條路徑跑通一次,後續要換成 SQL Server、MySQL 或任何 ORM 都只是替換資料來源而已。