本文示範如何在ASP.NET環境下,用AJAX打造一個可動態展開、收合,而且不必重整整頁的樹狀選單。核心精神是「按需載入」:唯有使用者真的展開某個節點時,才向後端請求它的子分類,回應到來後再以DOM動態組出清單,避免一次載入龐大資料。
頁面左側放一個承載樹狀結構的div,右側用iframe顯示選取後的內容。先在head中引入樹狀選單的樣式表:
<link type="text/css" href="../../Styles/tree_css/tree.css" rel="stylesheet">
版面骨架大致如下:左欄是樹,右欄是內容框架:
<table width=100% cellpadding=0 cellspacing=0 border=0>
<tr>
<td>
<div class="TreeMenu" id="CategoryTree" style="width:100%; height:489px"></div>
</td>
<td>
<iframe id="furl" style="height:497px; width:100%;"></iframe>
</td>
</tr>
</table>
ExpandSubCategory負責處理節點的展開邏輯:先判斷該分類是否已下載過子節點,若已下載就直接切換展開/收合狀態;否則先顯示「請稍候」的提示,再呼叫後端方法取得子分類。
function ExpandSubCategory(iCategoryID)
{
var li_father = el("li_" + iCategoryID);
if (li_father.getElementsByTagName("li").length > 0) //分類已下載
{
ChangeStatus(iCategoryID);
return;
}
li_father.className = "Opened";
switchNote(iCategoryID, true);
AJaxMethod.GetSubCategory(iCategoryID, GetSubCategory_callback);
}
回呼函式GetSubCategory_callback收到 DataSet 後,逐一走訪每個資料列,依是否為葉子節點動態組出li與a元素,最後掛到父節點底下,並移除「請稍候」提示:
function GetSubCategory_callback(response)
{
var dt = response.value.Tables[0];
if (dt.Rows.length > 0)
var iCategoryID = dt.Rows[0].FatherID;
var li_father = el("li_" + iCategoryID);
var ul = document.createElement("ul");
for (var i = 0; i < dt.Rows.length; i++)
{
if (dt.Rows[i].IsChild == 1) //葉子節點
{
var li = document.createElement("li");
li.className = "Child";
li.id = "li_" + dt.Rows[i].CategoryID;
var a = document.createElement("a");
a.href = "Javascript:OpenDocument('" + dt.Rows[i].CategoryID + "');";
a.innerHTML = dt.Rows[i].CategoryName;
li.appendChild(a);
}
else //可再展開的節點
{
var li = document.createElement("li");
li.className = "Closed";
li.id = "li_" + dt.Rows[i].CategoryID;
var img = document.createElement("img");
img.className = "s";
img.src = "../../Styles/tree_css/s.gif";
img.onclick = function () { ExpandSubCategory(this.id); };
img.alt = "展開/折疊";
var a = document.createElement("a");
a.href = "Javascript:ExpandSubCategory(" + dt.Rows[i].CategoryID + ");";
a.innerHTML = dt.Rows[i].CategoryName;
li.appendChild(img);
li.appendChild(a);
}
ul.appendChild(li);
}
li_father.appendChild(ul);
switchNote(iCategoryID, false);
}
其餘輔助函式各司其職:ChangeStatus切換節點的Opened/Closed樣式;switchNote負責插入或移除「請稍候」的佔位節點;OpenDocument在點選葉子節點時載入對應內容;PreloadFormUrl則以同步方式取得該分類的表單網址並指定給iframe。
頁面載入時先建立根節點,再展開第一層分類:
var tree = el("CategoryTree");
var root = document.createElement("li");
root.id = "li_0";
tree.appendChild(root);
ExpandSubCategory(0);
在Page_Load中註冊允許AJAX呼叫的型別:
protected void Page_Load(object sender, EventArgs e)
{
Utility.RegisterTypeForAjax(typeof(AjaxMethod));
}
AjaxMethod類別提供兩個被AJAX暴露的方法。GetSubCategory查詢指定父分類下的子分類,並用IsLeaf函式判斷是否為葉子;GetFormsList則取得該分類下的表單清單:
[AjaxMethod(HttpSessionStateRequirement.ReadWrite)]
public static DataSet GetSubCategory(int iCategoryID)
{
string sql = string.Format(
"SELECT CategoryID, CategoryName, FatherID, dbo.IsLeaf(CategoryID) as IsChild FROM Category WHERE FatherID = {0}",
iCategoryID);
return GetDataSet(sql);
}
[AjaxMethod(HttpSessionStateRequirement.ReadWrite)]
public static DataSet GetFormsList(int iCategoryID)
{
string sql = string.Format(
"SELECT * FROM forms WHERE form_category_id = {0}", iCategoryID);
return GetDataSet(sql);
}
tree.css透過.Opened、.Closed、.Child三種狀態,切換節點展開圖示;.Closed ul設定display:none來隱藏子層,達到收合效果:
.TreeMenu li { list-style:none; padding:0; }
.Closed ul { display:none; }
#CategoryTree .Opened img.s { background:url(skin3/opened.gif) no-repeat 0 1px; }
#CategoryTree .Closed img.s { background:url(skin3/closed.gif) no-repeat 0 1px; }
#CategoryTree .Child img.s { background:url(skin3/child.gif) no-repeat 13px 2px; }
資料層則由Category與Forms兩張表構成,前者以FatherID維繫父子關係,IsLeaf函式透過統計子節點數量來判定葉子:
CREATE FUNCTION IsLeaf (@cat_id int)
RETURNS int AS
BEGIN
declare @count int
select @count = (select count(*) from Category where FatherID=@cat_id)
if (@count=0) return 1
return 0
END
整份實作的要點在於「延遲載入」與「DOM動態組裝」:使用者點到哪裡,才向後端要哪裡的資料,讓龐大的分類樹也能保持輕快順暢,全程不必重整頁面。