【簡介】

zTree 是利用 JQuery 的核心代碼，實現一套能完成大部分常用功能的 Tree 插件

• 兼容 IE、FireFox、Chrome 等瀏覽器
• 在一個頁面內可同時生成多個 Tree 實例
• 支持 JSON 數據
• 支持一次性靜態生成 和 Ajax 異步加載 兩種方式
• 支持多種事件響應及反饋
• 支持 Tree 的節點移動、編輯、刪除
• 支持任意更換皮膚 / 個性化圖標（依靠css）
• 支持極其靈活的 checkbox 或 radio 選擇功能
• 簡單的參數配置實現 靈活多變的功能

zTree博客地址：http://ztreeapi.iteye.com/

目前zTree作者已經入駐ItEye，如果有什麽需要學習的完全可以到作者博客上去學習，而且zTree的版本已經更新了很多次了，下面的內容跟最新版估計會有很大出入，我不能保證下面的教程在最新版可用。zTree真的是非常強大的樹組件，希望能對大家有所幫助！

在官網能夠下載到zTree的源碼、實例和API，其中作者pdf的API寫得非常詳細（中文的哦）

【部分函數和屬性介紹】

• 核心：zTree(setting, [zTreeNodes])

這個函數接受一個JSON格式的數據對象setting和一個JSON格式的數據對象zTreeNodes，從而建立 Tree。

• 核心參數：setting

zTree 的參數配置都在這裏完成，簡單的說：樹的樣式、事件、訪問路徑等都在這裏配置

setting 舉例:

1. var setting = {
2. showLine: true,
3. checkable: true
4. };

因為參數太多，具體參數詳見zTreeAPI

• 核心參數：zTreeNodes

zTree 的全部節點數據集合，采用由JSON對象組成的數據結構，簡單的說：這裏使用Json格式保存了樹的所有信息

zTreeNodes的格式分為兩種：利用Json格式嵌套體現父子關系和Array簡單格式

①帶有父子關系的標準 zTreeNodes 舉例:

1. var zTreeNodes = [
2. {"id":1, "name":"test1", "nodes":[
3. {"id":11, "name":"test11", "nodes":[
4. {"id":111, "name":"test111"}
5. ]},
6. {"id":12, "name":"test12"}
7. ]},
8. ......
9. ];

②帶有父子關系的簡單 Array 格式(isSimpleData)的 zTreeNodes 舉例：

1. var treeNodes = [
2. {"id":1, "pId":0, "name":"test1"},
3. {"id":11, "pId":1, "name":"test11"},
4. {"id":12, "pId":1, "name":"test12"},
5. {"id":111, "pId":11, "name":"test111"},
6. ......
7. ];

【實例一】(Java代碼)

①在頁面引用zTree的js和css：

1. <!-- ZTree樹形插件 -->
2. <link rel="stylesheet" href="<%=root%>/Web/common/css/zTreeStyle/zTreeStyle.css" type="text/css">
3. <!-- <link rel="stylesheet" href="<%=root%>/Web/common/css/zTreeStyle/zTreeIcons.css" type="text/css"> -->
4. <script type="text/javascript" src="<%=root%>/Web/common/js/jquery-ztree-2.5.min.js"></script>

②在script腳本中定義setting和zTreeNodes

1. var setting = {
2. isSimpleData : true, //數據是否采用簡單 Array 格式，默認false
3. treeNodeKey : "id", //在isSimpleData格式下，當前節點id屬性
4. treeNodeParentKey : "pId", //在isSimpleData格式下，當前節點的父節點id屬性
5. showLine : true, //是否顯示節點間的連線
6. checkable : true //每個節點上是否顯示 CheckBox
7. };
9. var treeNodes = [
10. {"id":1, "pId":0, "name":"test1"},
11. {"id":11, "pId":1, "name":"test11"},
12. {"id":12, "pId":1, "name":"test12"},
13. {"id":111, "pId":11, "name":"test111"},
14. ];

③在進入頁面時生成樹結構：

1. var zTree;

1. $(function() {
2. zTree = $("#tree").zTree(setting, treeNodes);
3. });

④最後查看效果：

【實例二】(從後臺獲取簡單格式Json數據)

①後臺代碼封裝簡單格式Json數據：

1. public void doGetPrivilegeTree() throws IOException{
2. String s1 = "{id:1, pId:0, name:\"test1\" , open:true}";
3. String s2 = "{id:2, pId:1, name:\"test2\" , open:true}";
4. String s3 = "{id:3, pId:1, name:\"test3\" , open:true}";
5. String s4 = "{id:4, pId:2, name:\"test4\" , open:true}";
6. List<String> lstTree = new ArrayList<String>();
7. lstTree.add(s1);
8. lstTree.add(s2);
9. lstTree.add(s3);
10. lstTree.add(s4);
11. //利用Json插件將Array轉換成Json格式
12. response.getWriter().print(JSONArray.fromObject(lstTree).toString());
13. }

②頁面使用Ajax獲取zTreeNodes數據再生成樹

1. var setting = {
2. isSimpleData : true, //數據是否采用簡單 Array 格式，默認false
3. treeNodeKey : "id", //在isSimpleData格式下，當前節點id屬性
4. treeNodeParentKey : "pId", //在isSimpleData格式下，當前節點的父節點id屬性
5. showLine : true, //是否顯示節點間的連線
6. checkable : true //每個節點上是否顯示 CheckBox
7. };
9. var zTree;
10. var treeNodes;
12. $(function(){
13. $.ajax({
14. async : false,
15. cache:false,
16. type: ‘POST‘,
17. dataType : "json",
18. url: root+"/ospm/loginInfo/doGetPrivilegeTree.action",//請求的action路徑
19. error: function () {//請求失敗處理函數
20. alert(‘請求失敗‘);
21. },
22. success:function(data){ //請求成功後處理函數。
23. alert(data);
24. treeNodes = data; //把後臺封裝好的簡單Json格式賦給treeNodes
25. }
26. });
28. zTree = $("#tree").zTree(setting, treeNodes);
29. });

③最後顯示效果

【實例三】從後臺動態獲取數據，樹節點提供右鍵菜單功能

①配置setting：

1. var url = "/ospm/loginInfo/doGetPrivilegeTree.action";
2. //zTree基本設置
3. var setting = {
4. async : true, //需要采用異步方式獲取子節點數據,默認false
5. asyncUrl : root + url, //當 async = true 時，設置異步獲取節點的 URL 地址 ,允許接收 function 的引用
6. asyncParam : ["id"], //提交的與節點數據相關的必需參數
7. isSimpleData : true, //數據是否采用簡單 Array 格式，默認false
8. treeNodeKey : "id", //在isSimpleData格式下，當前節點id屬性
9. treeNodeParentKey : "parentId", //在isSimpleData格式下，當前節點的父節點id屬性
10. nameCol : "privName", //在isSimpleData格式下，當前節點名稱
11. expandSpeed : "fast", //設置 zTree節點展開、折疊時的動畫速度或取消動畫(三種默認定義："slow", "normal", "fast")或 表示動畫時長的毫秒數值(如：1000)
12. showLine : true, //是否顯示節點間的連線
13. callback : { //回調函數
14. rightClick : zTreeOnRightClick //右鍵事件
15. }
16. };

②配置鼠標右鍵事件，顯示右鍵菜單的代碼

1. //顯示右鍵菜單
2. function showRMenu(type, x, y) {
3. $("#rMenu ul").show();
4. if (type=="root") {
5. $("#m_del").hide();
6. $("#m_check").hide();
7. $("#m_unCheck").hide();
8. }
9. $("#rMenu").css({"top":y+"px", "left":x+"px", "display":"block"});
10. }
11. //隱藏右鍵菜單
12. function hideRMenu() {
13. $("#rMenu").hide();
14. }
16. //鼠標右鍵事件-創建右鍵菜單
17. function zTreeOnRightClick(event, treeId, treeNode) {
18. if (!treeNode) {
19. zTree.cancelSelectedNode();
20. showRMenu("root", event.clientX, event.clientY);
21. } else if (treeNode && !treeNode.noR) { //noR屬性為true表示禁止右鍵菜單
22. if (treeNode.newrole && event.target.tagName != "a" && $(event.target).parents("a").length == 0) {
23. zTree.cancelSelectedNode();
24. showRMenu("root", event.clientX, event.clientY);
25. } else {
26. zTree.selectNode(treeNode);
27. showRMenu("node", event.clientX, event.clientY);
28. }
29. }
30. }

1. <p><span style="#fafafa;"><!-- 右鍵菜單div -->
2. <div id="rMenu" style="position:absolute; display:none;">
3. <li>
4. <ul id="m_add" onclick="addPrivilege();"><li>增加</li></ul>
5. <ul id="m_del" onclick="delPrivilege();"><li>刪除</li></ul>
6. <ul id="m_del" onclick="editPrivilege();"><li>編輯</li></ul>
7. <ul id="m_del" onclick="queryPrivilege();"><li>查看</li></ul>
8. </li>
9. </div></span></p>

③頁面加載時生成樹並且監聽鼠標點擊事件，及時隱藏右鍵菜單

1. function reloadTree() {
2. hideRMenu();
3. zTree = $("#tree").zTree(setting, treeNodes);
4. }
6. var zTree;
7. var treeNodes = [];
10. $(function() {
11. reloadTree();
13. $("body").bind(//鼠標點擊事件不在節點上時隱藏右鍵菜單
14. "mousedown",
15. function(event) {
16. if (!(event.target.id == "rMenu" || $(event.target)
17. .parents("#rMenu").length > 0)) {
18. $("#rMenu").hide();
19. }
20. });
21. });

④後臺代碼根據id獲取樹節點信息

-----------------------Action層-----------------------

1. public void doGetPrivilegeTree() throws IOException{
2. String sId = request.getParameter("id");
3. int treeId = 0;
4. if(sId!=null&&!"".equals(sId)){
5. treeId = Integer.parseInt(sId);
6. }
7. List<Privilege> lstPriv = privilegeService.findPrivilegeTreeById(treeId);
8. response.setCharacterEncoding("UTF-8");
9. response.getWriter().print(JSONArray.fromObject(lstPriv).toString());
10. }

-----------------------Service層-----------------------

1. /**
2. * 根據節點id，查詢其下級節點的數據
3. */
4. @SuppressWarnings("unchecked")
5. @Override
6. public List<Privilege> findPrivilegeTreeById(int treeId) {
7. StringBuffer sbTree= new StringBuffer();
8. sbTree.append("SELECT NEW Privilege(p.id,p.privName,p.description,p.status,p.isLeaf,p.parentId) FROM Privilege p ");
9. sbTree.append("WHERE p.parentId=:treeId ");
10. sbTree.append("AND p.status!=:del ");
12. Map<String,Object> mapTree = new HashMap<String, Object>();
13. mapTree.put("treeId", treeId);
14. mapTree.put("del", Privilege.PRIV_STATUS_DELETE);
16. return (List<Privilege>) privilegeDao.findByHql(sbTree.toString(), mapTree);
17. }

⑤最後查看效果：

Jquery-zTree的基本用法