DIV CSS 佈局教程網

jQuery AJAX 搭配 JSON 資料的模板綁定實戰教學
編輯:JQuery特效代碼     

透過 jQuery 內建的 AJAX 功能向後端取得 JSON 資料,再把資料填進預先寫好的 HTML 模板裡渲染到畫面上,是早期非常常見的一種做法。整個過程可以拆成三塊:模板、請求、綁定。

一、先寫好 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 請求並綁定資料

$.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 都只是替換資料來源而已。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved