1 zTree的基本使用
1.0 zTree的创建
在页面中添加对zTree的js及css引用,由于zTree基于JQuery,JQuery的引用是必须的。
1.1 zTree的配置
zTree的配置采用Json格式,按照配置的类型分为view(可视界面相关配置)、data(数据相关配置)、check(复选框相关配置)、callback(各类事件的回调函数配置)、async(zTree异步加载配置),一下是我们经常会使用到的一些配置及说明,其他详细配置可以参考zTree官方API文档的详细介绍。
var setting = {
view: {
selectedMulti:true, //设置是否能够同时选中多个节点
showIcon:true, //设置是否显示节点图标
showLine:true, //设置是否显示节点与节点之间的连线
showTitle:true, //设置是否显示节点的title提示信息
},
data: {
simpleData: {
enable:false, //设置是否启用简单数据格式(zTree支持标准数据格式跟简单数据格式,上面例子中是标准数据格式)
idKey:"id", //设置启用简单数据格式时id对应的属性名称
pidKey:"pId" //设置启用简单数据格式时parentId对应的属性名称,ztree根据id及pid层级关系构建树结构
}
},
check:{
enable:true //设置是否显示checkbox复选框
},
callback: {
onClick: onClick, //定义节点单击事件回调函数
onRightClick: OnRightClick,//定义节点右键单击事件回调函数
beforeRename: beforeRename,//定义节点重新编辑成功前回调函数,一般用于节点编辑时判断输入的节点名称是否合法
onDblClick: onDblClick, //定义节点双击事件回调函数
onCheck: onCheck //定义节点复选框选中或取消选中事件的回调函数
},
async: {
enable:true, //设置启用异步加载
type:"get", //异步加载类型:post和get
contentType:"application/json", //定义ajax提交参数的参数类型,一般为json格式
url:"/Design/Get", //定义数据请求路径
autoParam: ["id=id","name=name"] //定义提交时参数的名称,=号前面标识节点属性,后面标识提交时json数据中参数的名称
}
};
需要注意的是,zTree的事件回调部分,基本上每一个事件都对应一个beforeXXX事件,比如onClick事件对应有一个beforeOnClick事件,主要用于控制相关事件是否允许执行,如果before事件返回false,则取消执行对应相关事件。
|
zTree的每一个节点都是一个treeNode对象,treeNode对象经常用到的属性和方法如下:
treeNode: {
name, //节点显示的文本
checked,//节点是否勾选,ztree配置启用复选框时有效
open, //节点是否展开
icon, //节点的图标
iconOpen,//节点展开式的图标
iconClose,//节点折叠时的图标
id, //节点的标识属性,对应的是启用简单数据格式时idKey对应的属性名,并不一定是id,如果setting中定义的idKey:"zId",那么此处就是zId
pId, //节点parentId属性,命名规则同id
children,//得到该节点所有孩子节点,直接下级,若要得到所有下属层级节点,需要自己写递归得到
isParent,//判断该节点是否是父节点,一般应用中通常需要判断只有叶子节点才能进行相关操作,或者删除时判断下面是有子节点时经常用到。
getPath()//得到该节点的路径,即所有父节点,包括自己,此方法返回的是一个数组,通常用于创建类似面包屑导航的东西A-->B-->C
}
zTree的数据源一般有标准数据格式、简单数据格式两种,标准数据格式通过指定节点的chidren属性构建层级关系,而简单数据格式根据根据id,pid属性构建层级关系,我们在应用开发中使用关系型数据库,一般采用的都是简单数据格式。
标准数据格式
简单数据格式
var nodes = [
{id:1, pId:0, name:"父节点1"},
{id:11, pId:1, name:"子节点1"},
{id:12, pId:1, name:"子节点2"}
];
注意zTree的默认配置是不启用简单数据格式,使用简单数据格式一定要在setting中进行简单数据格式的相关配置。
1.3 zTree的常用方法zTree的主要操作方法介绍如下
1) 获取zTree对象:vartreeObj = $.fn.zTree.getZTreeObj("tree");
2)增加节点:addNodes(parentNode,index,newNodes,isSlient)
parentNode:指定的父节点,如果增加根节点,请设置 parentNode 为 null 即可
index:新节点插入的位置(从 0 开始),index =-1 时,插入到最后,此参数可忽略
newNodes:需要增加的节点数据JSON 对象集合,数据只需要满足 zTree 的节点数据必需的属性即可
3)isSilent:true 时,添加节点后不展开父节点,其他值或缺省状态都自动展开
4)勾选或取消勾选全部节点:checkAllNodes(checked);
checked参数为true时全部勾选,为false时全部取消勾选。
5)勾选或取消勾选单个节点:checkNode(node,checked, checkedTypeFlag,callbackFlag);
node:要进行操作的节点
checked:为true勾选,为false取消勾选
checkeTypeFlag:为true表示对当前结点的子节点及父节点进行勾选状态的联动,为false不联动
callbackFlag:为true时表示执行beforeOnCheck和onCheck事件的回调函数,为false不执行
6)编辑节点 edit(node); 使节点处于编辑状态,必须引用jquery.ztree.exedit 扩展
7)展开或折叠全部节点:expandAll(expand);
expand为true是展开所有节点,为false是折叠所有节点。
8)根据节点属性查找结点:getNodesByParam(key,value,parentNode);
key:属性名
value:属性值
parentNode:是否在指定节点下查找,为null表示整个树查找。
9)获取被勾选或未被勾选的节点集合:getCheckedNodes(checked);
checked为true表示获取所有被勾选的节点集合,为false表示所有未被勾选的节点集合
10) 获取输入框勾选状态被改变的节点集合:getChangeCheckedNodes()
2 zTree的常用操作
2.0 ajax请求数据并创建zTree
$(function() {
varsetting = { //此处根据自己需要进行配置
view: {
selectedMulti:false
},
data: {
simpleData: {
enable:true
}
},
callback: {
onClick: onDesignTreeClick,
onRightClick: OnRightClick,
beforeRename: beforeRename, onCheck:onCheck
}
};
$.ajax({
type:"Get",
url:"/Design/GetDesignTreeData", //ajax请求地址
success:function (data) {
$.fn.zTree.init($("#treeZo"), setting, data);//加载数据
},
});
});
后台代码如下,可以根据需要返回你想要的任何数据,绑定到zTree上,然后通过treeNode.属性名取到对应的值,实现一些界面逻辑操作。
public ActionResult GetDesignTreeData()
{
var result = _designAppService.GetDesignTreeData();
List<ModelTreeViewModel> treeModels =new List<ModelTreeViewModel>();
boolopen = false;
foreach(var design inresult.Designs)
{
if(design.ParentId == Guid.Empty)
open =true;
elseopen = false;
treeModels.Add(newModelTreeViewModel() { Id = design.Id.ToString(), PId = design.ParentId.ToString(), Name = design.Name, Open = open, Data = design.Remarks ??"", ViewPoint = design.ViewPoint ??"", Checked =true });
}
returnJson(treeModels, JsonRequestBehavior.AllowGet);
}
2.1 节点单击操作
节点单击事件会捕获事件对象e,zTree的唯一标识treeId,当前选中的节点对象treeNode三个参数。根据实际需求可获取treeNode中包含的任何属性数据,进行相关操作 。
function onClick(e, treeId, treeNode) {
if(treeNode.isParent) //如果不是叶子结点,结束
return;
alert(treeNode.name);//获取当前结点上的相关属性数据,执行相关逻辑
};
2.2 节点复选框事件
一般情况下我们会直接使用treeObj.getCheckedNodes(true);获取所有选中的节点,然后遍历所有选中的节点进行相关操作,当面对大数据量时,这种操作方法便不可取,可通过getChangeCheckedNodes()方法获取勾选状态被改变的节点集合,值针对状态改变的节点做相应处理。
function onCheck() {
vartreeObj = $.fn.zTree.getZTreeObj("treeDemo");//获取树对象
varnodes = treeObj.getChangeCheckedNodes(); //获取勾选状态改变的节点
vardesignIds = [];
varstatus = 0; //定义初始勾选状态为未勾选
if(nodes[0].checked)
status = 1; //如果状态改变节点为勾选状态,说明当前操作是从未勾选变为已勾选。
$.each(nodes,function (i, item) {
designIds.push(item.id); //将状态改变的节点id输出到数组
item.checkedOld = item.checked; //这句话很关键,将节点的初始状态置为当前状态。否则每次勾选操作获取状态改变节点时只会跟树初始化的状态相比较。
})
$.ajax({
type:"Post",
url:"/Design/GetRelationComponentIdsByDesigns",
data: {"designIds": designIds },
success:function (data) {
RealBimOcx.BatchAddSubClrInfoBegin();
$.each(data.result,function (i, item) {
if(status == 1) //这里根据发生改变的节点是勾选还是为勾选进行相关逻辑操作。
RealBimOcx.AddSubClrInfo(item, 255, 255, 0);
else
RealBimOcx.AddSubClrInfo(item, 0, 255, 0);
if(i % 100 == 0) {
RealBimOcx.BatchAddSubClrInfoEnd();
RealBimOcx.BatchAddSubClrInfoBegin();
}
})
RealBimOcx.BatchAddSubClrInfoEnd();
}
})
};
2.3 实现zTree的右键增删改操作
首先定义右键弹出面板
1
2
3
4
5
6
7
8
9
10
11
12
|
<
div
id
=
"rMenu"
style
=
"z-index:100;"
>
<
ul
>
<
li
id
=
"m_add"
onclick
=
"addTreeNode();"
>新增节点</
li
>
<
li
id
=
"m_del"
onclick
=
"removeTreeNode();"
>删除节点</
li
>
<
li
id
=
"m_edit"
onclick
=
"editTreeNode();"
style
=
"border-bottom:1px solid #cecece"
>编辑节点</
li
><
li
id
=
"m_left"
>升级</
li
>
<
li
id
=
"m_right"
>降级</
li
>
<
li
id
=
"m_up"
>上移</
li
>
<
li
id
=
"m_down"
style
=
"border-bottom:1px solid #cecece"
>下移</
li
>
<
li
id
=
"m_reset"
onclick
=
"resetTree();"
>重置节点</
li
> <
li
id
=
"m_open"
onclick
=
"treeOpen()"
>展开所有</
li
>
<
li
id
=
"m_stop"
onclick
=
"treeStop()"
>收起所有</
li
>
</
ul
>
</
div
>
|
实现zTree右键单击事件回调函数
//右键单击回调函数
function OnRightClick(event, treeId, treeNode) {
$("#treeZo").hide();
if(!treeNode && event.target.tagName.toLowerCase() != "button" && $(event.target).parents("a").length == 0) {
zTree.cancelSelectedNode();
showRMenu("root", event.clientX, event.clientY);//根据鼠标位置显示右键操作面板
}else if (treeNode && !treeNode.noR) {
zTree.selectNode(treeNode);
showRMenu("node", event.clientX, event.clientY);
}
$("#treeZo").show();
}
//根据节点类型,控制右键操作菜单哪些可用哪些不可用
function showRMenu(type, x, y) {
$("#rMenu ul").show();
if(type == "root") {
$("#m_del").hide();
$("#m_edit").hide();
$("#m_left").hide();
$("#m_right").hide();
$("#m_up").hide();
$("#m_down").hide();
$("#m_add").addClass('mboder');
}else {
$("#m_del").show();
$("#m_edit").show();
$("#m_left").show();
$("#m_right").show();
$("#m_up").show();
$("#m_down").show();
$("#m_add").removeClass('mboder');
}
rMenu.css({"top": y + "px","left": x + "px","visibility": "visible" });
$("body").bind("mousedown", onBodyMouseDown);
}
//以藏右键面板
function hideRMenu() {
if(rMenu) rMenu.css({ "visibility":"hidden" });
$("body").unbind("mousedown", onBodyMouseDown);
}
//单击页面其他位置 隐藏右键面板
function onBodyMouseDown(event) {
if(!(event.target.id == "rMenu"|| $(event.target).parents("#rMenu").length > 0)) {
rMenu.css({"visibility": "hidden" });
}
}
新增节点
编辑节点
节点编辑状态离开时触发事件
删除节点数据
2.4 一些总结
我们通常使用到树形控件做授权或关联类似的操作,一般会先全部取消勾选,然后根据选中的数据关联对树控件的复选框进行选中操作,在大数据量时,大约几万条数据,全部取消勾选+根据关联数据勾选相关节点这个操作通过js执行会很慢,这种情况建议在后台通过关联关系重新组织zTree需要的数据源,对每条数据(对应树节点)设置checked属性,然后再前台页面重新加载树,这种操作速度要快得多。
$.ajax({
type:"Get",
url:"/Model/GetRelationModelTreeData?designId="+ treeNode.id + "&t="+ new Date(),
success:function (data) {
//$.each(data.result, function (i, item) {
// var node = modelTree.getNodeByParam("id", item, null);
// modelTree.checkNode(node, true, true);
//});
$.fn.zTree.init($("#treejian"), setting1, data.result);//改为重新加载,比js循环勾选速度要快。
}
});