由於專案中需要設計樹形選單功能,於是百度找相關資料,發現zTree方面的資料不少,覺得挺不錯,而且zTree官方也有API文檔,介紹的非常詳細,經過一番搗騰之後,終於給弄出來了,所以便記下來,也算是學習zTree的一個總結吧。
zTree的介紹:
1、zTree 是利用 JQuery 的核心程式碼,實作一套能完成大部分常用功能的 Tree 外掛程式
2、zTree v3.0 將核心程式碼依照功能進行了分割,不需要的程式碼可以不用載入
3、採用了 延遲加載 技術,上萬節點輕鬆加載,即使在 IE6 下也能基本做到秒殺
4、相容 IE、FireFox、Chrome、Opera、Safari 等瀏覽器
5、支援 JSON 資料
6、支援靜態 和 Ajax 非同步載入節點資料
7、支援任意更換皮膚 / 自訂圖示(依賴css)
8、支援極具彈性的 checkbox 或 radio 選擇功能
9、提供多種事件回應回呼
10、靈活的編輯(增/刪/改/查)功能,可隨意拖曳節點,還可以多節點拖曳喲
11、在一個頁面內可同時產生多個 Tree 實例
核心的函數與屬性介紹:
核心:zTree(setting, [zTreeNodes])
這個函數接受一個JSON格式的資料物件setting和一個JSON格式的資料物件zTreeNodes,從而建立 Tree。
核心參數:setting
zTree 的參數配置都在這裡完成,簡單的說:樹的樣式、事件、訪問路徑等都在這裡配置
var setting = { showLine: true, checkable: true };
因為參數太多,具體參數詳見zTreeAPI
核心參數:zTreeNodes
zTree 的全部節點資料集合,採用由JSON物件組成的資料結構,簡單的說:這裡使用Json格式保存了樹的所有資訊
1、zTree官方網站: http://www.ztree.me/v3/main.php#_zTreeInfo
在官網能夠下載到zTree的源碼、實例和API,其中作者pdf的API寫得非常詳細
關於zTree的節點資料的取得方式分為靜態(直接定義)的和動態(後台資料庫載入)的
具體的設定步驟:
第一步 —— 引入相關文件
<link rel="stylesheet" href="ztree/css/zTreeStyle/zTreeStyle.css" type="text/css"> <script type="text/javascript" src="js/jQuery/jquery-1.9.1.min.js"></script> <script type="text/javascript" src="ztree/js/jquery.ztree.core-3.5.min.js"></script> <script type="text/javascript" src="ztree/js/jquery.ztree.excheck-3.5.min.js"></script>
備註:
1)、第一個(zTreeStyle.css)是zTree的樣式css文件,引入了這個,才能呈現出樹形的結構樣式,
2)、第二個(jquery-1.9.1.min.js)是jQuery文件,因為要用到,
3)、第三個(jquery.ztree.core-3.5.min.js)則是zTree的核心js文件,這個是必須的,
4)、最後一個(js/jquery.ztree.excheck-3.5.min.js)則是拓展文件,主要用於單選框和復選框的功能,因為用到了複選框,所以也要引進來。
第二步 —— 相關配置(具體的詳細配置,請到官網參考詳細API文件)
var zTree; var setting = { view: { dblClickExpand: false,//双击节点时,是否自动展开父节点的标识 showLine: true,//是否显示节点之间的连线 fontCss:{'color':'black','font-weight':'bold'},//字体样式函数 selectedMulti: false //设置是否允许同时选中多个节点 }, check:{ //chkboxType: { "Y": "ps", "N": "ps" }, chkStyle: "checkbox",//复选框类型 enable: true //每个节点上是否显示 CheckBox }, data: { simpleData: {//简单数据模式 enable:true, idKey: "id", pIdKey: "pId", rootPId: "" } }, callback: { beforeClick: function(treeId, treeNode) { zTree = $.fn.zTree.getZTreeObj("user_tree"); if (treeNode.isParent) { zTree.expandNode(treeNode);//如果是父节点,则展开该节点 }else{ zTree.checkNode(treeNode, !treeNode.checked, true, true);//单击勾选,再次单击取消勾选 } } } };
第三步 —— 節點資料加載,呈現樹形結構
1)、html頁面,直接放一個ul就可以,資料最後會自動載入到這個ul元素裡面
<body> <div class="zTreeDemoBackground left"> <ul id="user_tree" class="ztree" style="border: 1px solid #617775;overflow-y: scroll;height: 500px;"></ul> </div> </body>
2)、js中進行資料的載入
一、靜態方式(直接定義)
var zNodes =[ { id:1, pId:0, name:"test 1", open:false}, { id:11, pId:1, name:"test 1-1", open:true}, { id:111, pId:11, name:"test 1-1-1"}, { id:112, pId:11, name:"test 1-1-2"}, { id:12, pId:1, name:"test 1-2", open:true}, ]; $(document).ready(function(){ $.fn.zTree.init($("#user_tree"), setting, zNodes); }); function onCheck(e,treeId,treeNode){ var treeObj=$.fn.zTree.getZTreeObj("user_tree"), nodes=treeObj.getCheckedNodes(true), v=""; for(var i=0;i<nodes.length;i++){ v+=nodes[i].name + ","; alert(nodes[i].id); //获取选中节点的值 } }
二、動態方式(從後台資料庫載入)
/** * 页面初始化 */ $(document).ready(function(){ onLoadZTree(); }); /** * 加载树形结构数据 */ function onLoadZTree(){ var treeNodes; $.ajax({ async:false,//是否异步 cache:false,//是否使用缓存 type:'POST',//请求方式:post dataType:'json',//数据传输格式:json url:$('#ctx').val()+"SendNoticeMsgServlet?action=loadUserTree",//请求的action路径 error:function(){ //请求失败处理函数 alert('亲,请求失败!'); }, success:function(data){ // console.log(data); //请求成功后处理函数 treeNodes = data;//把后台封装好的简单Json格式赋给treeNodes } }); var t = $("#user_tree"); t = $.fn.zTree.init(t, setting, treeNodes); }
java後台載入資料碼:
1、定義tree的VO類,這個也可以不用定義,由於我要用到其他操作,方便一些
/** * zTree树形结构对象VO类 * * @author Administrator * */ public class TreeVO { private String id;//节点id private String pId;//父节点pId I必须大写 private String name;//节点名称 private String open = "false";//是否展开树节点,默认不展开 public String getId() { return id; } public void setId(String id) { this.id = id; } public String getpId() { return pId; } public void setpId(String pId) { this.pId = pId; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getOpen() { return open; } public void setOpen(String open) { this.open = open; } }
2、查詢資料庫,且sql的結構欄位也要是id,pId,name,open(可選)這種格式(注意:pId中間的I必須大寫),然後將結果封裝到TreeVO類別中。
/** * 加载树形结构数据 * @param request * @param response * @throws IOException */ public void loadUserTree(HttpServletRequest request, HttpServletResponse response) throws IOException{ WeiXinUserService weixinUserService = new WeiXinUserServiceImpl(); List<TreeVO> user_tree_list = weixinUserService.getUserTreeList(); String treeNodesJson = JSONArray.fromObject(user_tree_list).toString();//将list列表转换成json格式 返回 PrintWriter out = response.getWriter(); //利用Json插件将Array转换成Json格式 out.print(treeNodesJson); //释放资源 out.close(); }
這裡就完成了整個操作了,誒,文筆不好,組織語言自然就不怎麼樣了,大家見諒!共同學習,共同成長!