由於項目中需要設計樹形菜單功能,於是百度找相關資料,發現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 實例
12、簡單的參數配置實現 靈活多變的功能
核心的函數和屬性介紹:
核心:zTree(setting, [zTreeNodes])
這個函數接受一個JSON格式的數據對象setting和一個JSON格式的數據對象zTreeNodes,從而建立 Tree。
核心參數:setting
zTree 的參數配置都在這裡完成,簡單的說:樹的樣式、事件、訪問路徑等都在這裡配置
setting 舉例:
var setting = { showLine: true, checkable: true };
因為參數太多,具體參數詳見zTreeAPI
核心參數:zTreeNodes
zTree 的全部節點數據集合,采用由JSON對象組成的數據結構,簡單的說:這裡使用Json格式保存瞭樹的所有信息
1、zTree官方網站:https://www.ztree.me/v3/main.php#_zTreeInfo
在官網能夠下載到zTree的源碼、實例和API,其中作者pdf的API寫得非常詳細
關於zTree的節點數據的獲取方式分為靜態(直接定義)的和動態(後臺數據庫加載)的
具體的配置步驟:
第一步 —— 引入相關文件
<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元素裡面
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 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(); }
這裡就完成瞭整個操作瞭,誒,文筆不好,組織語言自然就不怎麼樣瞭,大傢見諒!共同學習,共同成長!