組織架構、商品分類這類階層資料,用樹狀控件呈現最合適。本文示範以 zTree 建立非同步載入的樹,並在節點點擊時把選中值回寫到表單隱藏欄位。
// 業務類型樹
var settingOther = {
edit: {
enable: false
},
// 異步加載樹
async: {
enable: true,
url:"initCoagencyTree.action",
autoParam:["id", "name=n"],
otherParam:{"otherParam":"zTreeAsyncTest"},
dataFilter: filter
},
// 簡單數據格式
data: {
simpleData: {
enable: true
}
},
callback: {
beforeClick: beforeClick,
onClick: onClick
}
};
幾個關鍵設定:async.enable 打開非同步(展開節點時才向後端要子節點,資料量大時很省頻寬);simpleData.enable 表示用「id / pId」的扁平結構而非巢狀 children;autoParam 決定送出哪些參數,name=n 的意思是「把 name 改名為 n 再送」。
// 鼠標事件
function beforeClick(treeId, treeNode, clickFlag) {
if(clickFlag==1){
parent.document.getElementById("coagencyId").value=treeNode.id;
parent.document.getElementById("parentId").value=treeNode.pId;
parent.document.getElementById("name").value=treeNode.name;
$("#coagencyId").attr("value",treeNode.id);
$("#parentId").attr("value",treeNode.pId);
}else{
$("#coagencyId").attr("value",null);
$("#parentId").attr("value",null);
}
return (treeNode.click != false);
}
function onClick(event, treeId, treeNode, clickFlag) {
parent.showCoagencyDetail();
}
beforeClick 回傳 false 可以取消這次選取,這裡用 treeNode.click != false 讓後端能針對特定節點禁用點擊。
// 異步加載返回資料的處理
function filter(treeId, parentNode, childNodes) {
if (!childNodes) return null;
for (var i=0; i<childNodes.length; i++) {
childNodes[i].name = childNodes[i].name.replace(/.n/g, '.');
}
return childNodes;
}
function beforeAsync(treeId, treeNode) {
return treeNode ? treeNode.level < 5 : true;
}
$(document).ready(function(){
$.fn.zTree.init($("#coagencyTree"),settingOther);
});
beforeAsync 限制最多展開到第 5 層,避免過深遞迴載入。
<ul id="coagencyTree" class="ztree" style="height: 640px"></ul>
<div class="zTreeDemoBackground left"></div>
回寫值改用 val()。.attr("value", ...) 在 jQuery 1.6 之後對表單元素的行為與 .val() 不同,可能不會真正改變送出值,請統一改用 .val()。
後端回傳請檢查權限。樹的每個節點通常對應一筆實體資料,非同步載入意味著使用者可以任意猜 id 去呼叫那個 action。後端必須驗證請求者是否有權限存取該節點,否則等於開了一個資料外洩的門。
鍵盤與螢幕閱讀器。zTree 有提供 keyboard 相關設定與 ARIA 支援選項,預設未必全開。若 this 樹是主要操作介面,建議啟用並實測 Tab/方向鍵/Enter 的行為,並用 role="tree"、role="treeitem" 與 aria-expanded 標示展開狀態。
效能。節點數破千時可考虑虛擬滾動或分層載入;同时 filter 中的 replace 每次展開都跑一遭,若資料格式固定,最好在後端就處理乾淨。