過去我很少用JavaScript去實作分頁功能,主要是嫌麻煩;但認識jQuery之後,這種想法徹底改變了。有了這樣的腳本組件,就能在編寫腳本時把邏輯與HTML分離,讓高重用性的腳本更好維護。本文介紹一份在學習jQuery過程中寫成的、基於AJAX的資料查詢、排序與分頁複用腳本——只要按規則描述HTML並引入腳本檔,就能輕鬆實現上述功能。
這份腳本靠「約定」運作,只要HTML遵守以下慣例即可,無需再寫任何 JavaScript:
· 表單ID為viewform;
· 顯示資料的div ID為listview;
· 分頁按鈕以自訂屬性pageindex標示頁碼;
· 排序按鈕以自訂屬性orderfield標示排序欄位(如employeeid desc);
· 隱藏欄位orderfield與pageindex分別承載排序與頁碼狀態。
onInitPaging負責掃描帶有orderfield或pageindex屬性的元素,為它們掛上點擊事件;點擊時把對應值寫入隱藏欄位,再觸發AJAX提交:
function onInitPaging()
{
$("#listview").find("[@orderfield]").each(function(i)
{
var ordervalue = $(this).attr("orderfield");
$(this).click(function()
{
$("#orderfield").val(ordervalue);
onSubmitPage();
});
});
$("#listview").find("[@pageindex]").each(function(i)
{
var piValue = $(this).attr("pageindex");
$(this).click(function()
{
$("#pageindex").val(piValue);
onSubmitPage();
});
});
}
onSubmitPage以jQuery表單插件的AjaxSubmit送出表單,成功後把回傳的HTML塞回listview,並重新初始化分頁事件:
function onSubmitPage()
{
var options = {
success: function (data){
$("#listview").html(data);
onInitPaging();
}
};
$('#viewform').ajaxSubmit(options);
}
頁面載入時先綁定搜尋按鈕(點擊時把頁碼歸零再提交),並立即載入第一頁資料:
$(document).ready(function()
{
$("#search").click(function(){
$("#pageindex").val('0');
onSubmitPage();
});
onSubmitPage();
});
由於邏輯都在腳本裡,HTML只要依規則描述、並依序引入所需檔案即可:
<script src="jquery-latest.js"></script> <script src="form.js"></script> <script src="pagination.js"></script> <form id="viewform" method="post" action="FrmOrderView.aspx"> <input id="orderfield" name="orderfield" type="hidden" value="" /> <input id="pageindex" name="pageindex" type="hidden" value="0" /> ... <div id="listview"></div> </form>
資料提供頁(FrmOrderView.aspx)則負責輸出可排序的表頭與分頁連結,並用自訂屬性描述其行為:
<a href="#" pageindex="0">首頁</a>
<a href="#" pageindex="<%=dataview.PrevPage%>">上一頁</a>
<a href="#" pageindex="<%=dataview.NextPage%>">下一頁</a>
<a href="#" orderfield="<%=dataview.GetOrderInfo("CompanyName")%>">CustomerName</a>
後端Controller則依頁碼與排序欄位查詢對應資料並綁定到畫面:
[HFSoft.MVC.FormMapper("~/frmorderview.aspx")]
public void OrderView()
{
HFSoft.MVC.IDataViewContext viewcontext = (HFSoft.MVC.IDataViewContext)this.FormContext;
OrderSearch search = viewcontext.BindObject<OrderSearch>();
IExpression exp = search.GetExpression();
FieldAdapter[] orderby = null;
if (viewcontext.OrderField != null && viewcontext.OrderField != string.Empty)
orderby = new FieldAdapter[]{ new FieldAdapter(viewcontext.OrderField, null) };
Region region = new Region(viewcontext.PageIndex * 10, viewcontext.PageIndex * 10 + 10);
viewcontext.DataItems = exp.List<Order_v>(region, orderby);
viewcontext.PageSize = 10;
viewcontext.RecordCount = exp.CountOf<Order_v>();
}
整套方案的精髓,是巧用HTML的自訂屬性來承載「查詢、排序、分頁」的意圖。前端只需描述、不需編程,後端則依狀態取回對應資料,讓複雜的分頁互動變得優雅而可重用。