其實Ztree官網已經有詳細的API文檔,一切以官網上的說明為准,我在此只是結合實踐總結幾條常用的ztree的功能特性.
(ztree的語法結構是基於key-value的形式配置)
1:支持異步加載數據
語法配置:
1 async: { 2 enable: true, 3 4 url:'abc.ashx', 5 6 otherParam: { "request": "requestname" } 7 8 }簡要說明:
enable :設置 zTree 是否開啟異步加載模式.
url:Ajax 獲取數據的 URL 地址.
otherParam:Ajax 請求提交的靜態參數鍵值對.相當於ajax中的data參數.
2:加載數據並綁定,一般都是定義數據結構實體即model,此數據結構要包含層級關系通常包括:ID,父ID,Name.
然後配置語法:
1 data: { 2 simpleData: { 3 enable: true 4 } 5 }或者
1 data: { 2 key: { 3 children: "childrens", 4 5 checked: "IsChecked" 6 } 7 }簡要說明:
simpleData:即可采用數組作為數據源綁定.此時異步加載的數據可為平行結構.
children: 指定節點數據中保存子節點數據的屬性名稱,此時異步加載的數據為樹的折疊結構;所以後端加載數據時要使用遞歸算法.
3:支持單選,復選功能
語法配置:
01 check: { 02 enable: true, 03 chkStyle: "checkbox", 04 radioType: "all" 05 chkboxType:{ "Y": "", "N": "" } 06 }, 07 08 data: { 09 key: { 10 11 checked: "IsChecked" 12 } 13 }簡要說明:
enable:設置 zTree 的節點上是否顯示 checkbox / radio
chkStyle:勾選框類型(checkbox 或 radio)
radioType:radio 的分組范圍
chkboxType:勾選 checkbox 對於父子節點的關聯關系
checked:為加載數據後復選框是否勾選.IsChecked為後端數據結構model中定義的字段.
4:支持添加子節點,編輯節點,刪除節點事件
我這裡介紹如何采用自定義添加,編輯,刪除按鈕的方式
語法配置:
1 view: { 2 addHoverDom: addHoverDom, 3 removeHoverDom: removeHoverDom 4 }其中addHoverDom 函數為:
1 function addHoverDom(treeId, treeNode) { 2 var sObj = $("#" + treeNode.tId + "_span"); 3 if ($("#addBtn_" + treeNode.id).length > 0) return; 4 var str= "<a id='addBtn_" + treeNode.id + "' onclick='自定義函數1(" + treeNode.DepartmentID + ")'>添加子節點</a>"; 5 str+= "<a id='addBtn1_" + treeNode.id + "' onclick='自定義函數2(" + treeNode.DepartmentID + ")'>編輯節點</a>"; 6 str+= "<a id='addBtn2_" + treeNode.id + "' onclick='自定義函數3(" + treeNode.DepartmentID + ")'>刪除節點</a>"; 7 sObj.after(str); 8 };其中removeHoverDom函數為:
1 function removeHoverDom(treeId, treeNode) { 2 $("#addBtn_" + treeNode.id).unbind().remove(); 3 $("#addBtn1_" + treeNode.id).unbind().remove(); 4 $("#addBtn2_" + treeNode.id).unbind().remove(); 5 };簡要說明:
addHoverDom:用於當鼠標移動到節點上時,顯示用戶自定義控件,顯示隱藏狀態同 zTree 內部的編輯、刪除按鈕
removeHoverDom:用於當鼠標移出節點時,隱藏用戶自定義控件,顯示隱藏狀態同 zTree 內部的編輯、刪除按鈕