用 AjaxPro 這套框架做了一個動態樹狀選單,整體寫法很合自己的習慣,程式碼也不複雜,視覺的部分完全交給 CSS 負責。因為家裡的電腦裝不了 MS SQL,索性改用 MySQL,順道練習了一下 MySQL 的自訂函式。
樹狀結構的最小充分設計只有三個欄位:自己的代碼、名稱、父代碼。
create table category(
categoryid int,
categoryname varchar(20),
fatherid int
);
真正好用的是一個自訂函式,用來判斷某個分類底下還有沒有子項——這決定了前端要畫「可展開」還是「葉子」的圖示:
DELIMITER //
create function IsLeaf(cat_id int)
returns int
begin
declare cnt int;
select count(*) into cnt from category where fatherid = cat_id;
if cnt = 0 then
return 1; -- 沒有子項,是葉節點
end if;
return 0;
end;
//
有了它,查詢子分類時就能一次帶回每個項目的展開狀態:
insert into category values(1, 'My Documents', 0); insert into category values(2, 'ASP.Net', 1); insert into category values(3, 'Java', 1); insert into category values(4, 'C#', 1);
using System.Data;
using System.Web.UI;
using AjaxPro;
using MySql.Data.MySqlClient;
public partial class Tree : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
// 註冊型別,AjaxPro 才會產生前端可呼叫的代理
Utility.RegisterTypeForAjax(typeof(Tree));
}
[AjaxMethod()]
public DataSet GetSubCategory(int iCategoryID)
{
DataSet ds = new DataSet();
MySqlConnection conn =
new MySqlConnection("server=127.0.0.1;uid=root;pwd=你的密碼;database=test");
MySqlCommand cmd = conn.CreateCommand();
cmd.CommandText = string.Format(
"SELECT CategoryID, CategoryName, FatherID, IsLeaf(CategoryID) AS IsChild " +
"FROM Category WHERE FatherID = {0}", iCategoryID);
MySqlDataAdapter da = new MySqlDataAdapter(cmd);
try { da.Fill(ds); }
catch (MySqlException) { }
finally { conn.Close(); }
return ds;
}
[AjaxMethod()]
public DataSet GetDocInfoInCategory(int iCategoryID)
{
DataSet ds = new DataSet();
// 只取該分類底下、且本身為葉節點的項目
// SQL 略,結構同上,條件加上 AND IsLeaf(CategoryID) = 1
return ds;
}
}
請注意:字串拼接 SQL 有 Injection 風險,實務請改用 MySqlParameter 參數化查詢;連線字串也不該寫死在程式碼裡,放到 web.config 才是恰當做法。
// 展開某分類:若尚未下載過子項,才向伺服器索取
function expandSubCategory(iCategoryID) {
var li = document.getElementById("li_" + iCategoryID);
if (li.getElementsByTagName("li").length > 0) {
changeStatus(iCategoryID); // 已載入過,只做收合切換
displayDocList(iCategoryID);
return;
}
li.className = "Opened";
switchNote(iCategoryID, true); // 先顯示「請稍候…」
Tree.GetSubCategory(iCategoryID, getSubCategory_callback);
}
function getSubCategory_callback(response) {
var dt = response.value.Tables[0];
var iCategoryID = dt.Rows[0].FatherID;
var li = document.getElementById("li_" + iCategoryID);
var ul = document.createElement("ul");
for (var i = 0; i < dt.Rows.length; i++) {
var row = dt.Rows[i];
var item = document.createElement("li");
item.id = "li_" + row.CategoryID;
item.className = (row.IsChild == 1) ? "Child" : "Closed";
var img = document.createElement("img");
img.className = "s";
img.src = "css/s.gif";
var a = document.createElement("a");
a.href = "javascript:expandSubCategory(" + row.CategoryID + ");";
a.innerHTML = row.CategoryName;
if (row.IsChild != 1) {
img.onclick = function () { expandSubCategory(this.id); };
img.alt = "展開/收合";
}
item.appendChild(img);
item.appendChild(a);
ul.appendChild(item);
}
li.appendChild(ul);
switchNote(iCategoryID, false); // 移除「請稍候…」
displayDocList(iCategoryID);
}
// 收合/展開的樣式切換
function changeStatus(iCategoryID) {
var li = document.getElementById("li_" + iCategoryID);
li.className = (li.className == "Closed") ? "Opened" : "Closed";
}
// 載入時插入或移除提示節點
function switchNote(iCategoryID, show) {
var li = document.getElementById("li_" + iCategoryID);
if (show) {
var ul = document.createElement("ul");
ul.id = "ul_note_" + iCategoryID;
var li2 = document.createElement("li");
li2.className = "Child";
li2.innerHTML = "請稍候…";
ul.appendChild(li2);
li.appendChild(ul);
} else {
var old = document.getElementById("ul_note_" + iCategoryID);
if (old) { li.removeChild(old); }
}
}
// 首屏載入第一層
var tree = document.getElementById("CategoryTree");
var root = document.createElement("li");
root.id = "li_0";
tree.appendChild(root);
expandSubCategory(0);
樹的三種狀態——收合、展開、葉子——各自對應一張圖,其餘交給 class 切換,這是最省力的做法:
.TreeMenu ul { padding: 0; }
.TreeMenu li { list-style: none; padding: 0; }
.Closed ul { display: none; } /* 收合時隱藏子層 */
.Child img.s { cursor: default; } /* 葉節點不可點 */
#CategoryTree img.s { width: 34px; height: 18px; }
#CategoryTree .Opened img.s { background: url(skin/opened.gif) no-repeat 0 1px; }
#CategoryTree .Closed img.s { background: url(skin/closed.gif) no-repeat 0 1px; }
#CategoryTree .Child img.s { background: url(skin/child.gif) no-repeat 13px 2px; }
按需載入是重點:分類多達數千筆時,一次全部渲染會讓頁面卡住,而這套做法只在使用者展開時才請求該層資料,並把結果留在 DOM 裡,第二次展開不必再問伺服器。加上「請稍候…」的過渡節點,等待期間畫面也不會一片空白。
另外值得一提的是,資料庫端用函式判斷葉節點,讓前端省下一次額外查詢——把「結構判斷」放在最靠近資料的地方,往往比在應用層繞一圈更乾淨。