zTree 官网已有详细的 API 文档,一切以官网说明为准,这里我只是结合实际项目,总结几条常用的 zTree 功能特性。zTree 的配置语法是基于 key-value 的形式。
async: {
enable: true,
url:'abc.ashx',
otherParam: { "request": "requestname" }
}
简要说明:enable 设置是否开启异步加载模式;url 是 Ajax 获取数据的地址;otherParam 是 Ajax 请求提交的静态参数键值对,相当于 ajax 中的 data 参数。
一般先定义数据结构实体(model),通常包含 ID、父 ID、Name 以体现层级关系,然后配置:
data: { simpleData: { enable: true } }
或者:
data: { key: { children: "childrens", checked: "IsChecked" } }
简要说明:simpleData 可采用数组作为数据源绑定,此时异步加载的数据可为平行结构;children 指定节点数据中保存子节点数据的属性名称,此时异步加载的数据为树的折叠结构,所以后端加载数据时要使用递归算法。
check: {
enable: true,
chkStyle: "checkbox",
radioType: "all",
chkboxType:{ "Y": "", "N": "" }
},
data: { key: { checked: "IsChecked" } }
简要说明:enable 设置节点上是否显示 checkbox / radio;chkStyle 是勾选框类型(checkbox 或 radio);radioType 是 radio 的分组范围;chkboxType 是勾选 checkbox 对于父子节点的关联关系;checked 则对应加载数据后复选框是否勾选,IsChecked 为后端 model 中定义的字段。
这里介绍如何采用自定义按钮的方式来实现:
view: { addHoverDom: addHoverDom, removeHoverDom: removeHoverDom }
其中 addHoverDom 函数如下:
function addHoverDom(treeId, treeNode) {
var sObj = $("#" + treeNode.tId + "_span");
if ($("#addBtn_" + treeNode.id).length > 0) return;
var str= "<a id='addBtn_" + treeNode.id + "' onclick='自定义函数1(" + treeNode.DepartmentID + ")'>添加子节点</a>";
str+= "<a id='addBtn1_" + treeNode.id + "' onclick='自定义函数2(" + treeNode.DepartmentID + ")'>编辑节点</a>";
str+= "<a id='addBtn2_" + treeNode.id + "' onclick='自定义函数3(" + treeNode.DepartmentID + ")'>删除节点</a>";
sObj.after(str);
};
其中 removeHoverDom 函数如下:
function removeHoverDom(treeId, treeNode) {
$("#addBtn_" + treeNode.id).unbind().remove();
$("#addBtn1_" + treeNode.id).unbind().remove();
$("#addBtn2_" + treeNode.id).unbind().remove();
};
简要说明:addHoverDom 用于当鼠标移动到节点上时显示用户自定义控件,显示隐藏状态同 zTree 内部的编辑、删除按钮;removeHoverDom 则用于鼠标移出节点时隐藏这些自定义控件。通过这套机制,就能在树节点上灵活挂载增删改的自定义操作入口。