根據筆者的專案實踐,一個理想的 TreeView 至少要滿足五個關鍵指標:
本篇要打造的 TreeView,正是為了實現這五個指標。以下先展示效果,再逐步拆解實作。
首先是決定用什麼 HTML 來建構節點。常見有幾種做法:
table 套 table:樣式好控制,但面對大資料量與層次深的樹明顯力不從心。
UL 套 LI:結構簡潔,在不支援 JS 的瀏覽器上也能呈現樹狀(如 jQuery.treeview)。但 jQuery.treeview 的節點在 IE6 下無法被內部元素撐開,IE7、IE8 達到一定深度時也會錯位,推測與其用 padding 做縮進、以負值 margin-left 控制圖標位置有關,修改起來頗有難度。
div 套 table:如 CSDN 的導航樹,屬折中方案,節點不算太複雜、CSS 也好寫。
筆者採用第二種 UL 套 LI,但縮進改以「填空」方式處理——用空白圖片填滿縮進位置,藉此避開 jQuery.treeview 的錯位問題。
確定了節點 HTML 結構,接著就能撰寫 CSS。以下為完整樣式碼(節錄關鍵部分):
.bbit-tree ul,.bbit-tree li { list-style-type:none; margin:0px; padding:0px; }
.bbit-tree-body { font-size:12px; }
.bbit-tree-node { white-space: nowrap; }
.bbit-tree-node-el { line-height:18px; cursor:default; }
.bbit-tree-node a { text-decoration:none; }
.bbit-tree-node a span { text-decoration:none; padding:1px 3px 1px 2px; }
.bbit-tree-node .bbit-tree-node-over { background-color:#eee; }
.bbit-tree-node .bbit-tree-selected { background-color:#d9e8fb; }
/* 圖標可於此替換 */
.bbit-tree-node-expanded .bbit-tree-node-icon{ background-image:url(images/tree/folder-open.gif); }
.bbit-tree-node-leaf .bbit-tree-node-icon{ background-image:url(images/tree/leaf.gif); }
.bbit-tree-node-collapsed .bbit-tree-node-icon{ background-image:url(images/tree/folder.gif); }
.bbit-tree-node-loading .bbit-tree-node-icon{ background-image:url(images/tree/loading.gif) !important; }
除了基本樣式,還定義了「帶連接線的 + 號」與「不帶線的 + 號」兩種風格(bbit-tree-lines、bbit-tree-no-lines、bbit-tree-arrows),可視需求切換。
資料本身帶有層次,非常利於遍歷,這在後續的級聯關聯中尤其方便:
var menudata = [{
id: "0.1", // 唯一 ID
text: "Beyondbit UI Demo",
hasChildren: true,
isexpand: true,
complete: true,
ChildNodes: [{
id: "0.1.1",
text: "日期選擇",
hasChildren: true,
isexpand: false,
complete: true,
ChildNodes: [ /* ... */ ]
}]
}];
以下為完整的 treeview 插件核心程式碼:
(function($) {
$.fn.treeview = function(settings) {
var dfop = {
method: "POST", datatype: "json", url: false,
cbiconpath: "/images/icons/",
icons: ["checkbox_0.gif", "checkbox_1.gif", "checkbox_2.gif"],
showcheck: false, // 是否顯示選擇框
oncheckboxclick: false,// checkstate 變化時觸發(不含級聯引起者)
onnodeclick: false,
cascadecheck: true, // 是否啟用級聯
data: null, // 初始化資料
clicktoggle: true,
theme: "bbit-tree-arrows" // bbit-tree-lines / bbit-tree-no-lines / bbit-tree-arrows
};
$.extend(dfop, settings);
var treenodes = dfop.data;
var me = $(this);
var id = me.attr("id") || ("bbtree" + new Date().getTime());
me.attr("id", id);
var html = [];
buildtree(dfop.data, html); // 生成展開節點的 HTML
me.addClass("bbit-tree").html(html.join(""));
InitEvent(me); // 初始化事件
html = null;
// ... 後續 buildnode、nodeclick、check、cascade、bubble 等函式
return me;
};
})(jQuery);
首先,插件骨架:以 (function($){ ... })(jQuery) 閉包傳入 jQuery,避免與其他函式庫衝突;再用 $.extend(dfop, settings) 讓外部參數覆蓋預設值。
其次,效能關鍵——懶載入與 innerHTML:未展開的節點其 HTML 並不生成,只在展開時才動態建構,這要求樹內部維護一套資料(開銷很小),對效能的提升相當明顯。此外,展開節點時是一次性組裝整段 HTML 再以 innerHTML 一次寫入,而非逐一 append——因為直接操作 innerHTML 比 DOM 原生方法快上數倍(節點越多差距越大),這點切記。
節點路徑(Path):在生成節點的同時一併產生節點路徑,方便後續檢索定位。
事件註冊:透過 InitEvent 為節點附加 hover 與 click 事件;node 的 click 是核心,需依事件源的 class 判斷點擊對象,分別處理展開收縮、Checkbox 級聯、以及觸發自訂的 onnodeclick。
級聯的兩個難題:一是遍歷子節點(cascade),二是上溯到祖節點(bubble)。由於資料本身帶層次,兩者都變得相當直觀。核心的 check 回呼函式會判斷當前節點狀態:向下時子隨父同;向上時則需檢查所有子節點是否全選,若有一項未選中,父節點即進入「半選」狀態。
插件對外公開了幾個實用方法:取得所有選中節點、取得所有選中節點的值、以及取得當前節點,方便外部取用操作結果。
Q:如何為每個節點設定不同圖標?
A:其實無需擴展,插件本身已支援,只是未加說明。在 buildnode 方法中有這麼一句:if (nd.classes) { cs.push(nd.classes); }。也就是說,節點資料可設定 classes 屬性,該屬性會作為特殊的 CSS class 附加到節點上。只要為該 class 撰寫對應的樣式(例如指定不同的背景圖),即可輕鬆實現每個節點各自的圖標。
整體而言,這套 TreeView 兼顧了靜態與異步載入、Checkbox 級聯、大資料量效能與跨瀏覽器相容性,並透過懶載入與 innerHTML 兩大手法把效能發揮到相當水準,是一個兼具實用性與教學價值的完整範例。