ztree的简单使用

zTree简介

zTree 是一个依靠 jQuery 实现的多功能 “树插件”。优异的性能、灵活的配置、多种功能的组合是 zTree 最大优点。 
zTree 是开源免费的软件（MIT 许可证）。

使用zTree

其实zTree的API已经说得足够明白了，自己再记录一遍加深一下印象。

• 引入资源 
  向页面中引入jQuery的js文件，zTree的js文件和CSS文件。

• 页面添加zTree的容器，class属性为ztree

<ul id="treeDemo" class="ztree"></ul>

• 1

• 引入数据 
  zTree可以解析json格式的数据，有两种方式可以把数据传给zTree组件来生成树状结构：

1）直接把json数据传给组件。

$(document).ready(function(){
    $.fn.zTree.init($("#treeDemo"), setting, zNodes);
});

• 1
• 2
• 3

2）异步获取json格式数据，第三个参数传null或者空着。

$(document).ready(function(){
    $.fn.zTree.init($("#treeDemo"), setting, null);
});

• 1
• 2
• 3

使用demo

如果说使用上有什么需要注意的地方，那就是设置自己的层级关系字段了

var setting = {
    data: {
        key : {
            title : "c01name", //鼠标悬停显示的信息
            name : "c01name" //网页上显示出节点的名称
        },
        simpleData: {
            enable: true,
            idKey: "c01id", //修改默认的ID为自己的ID
            pIdKey: "c01parentid",//修改默认父级ID为自己数据的父级ID
            rootPId: 000     //根节点的ID
        }
    }
};

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14

有时候异步处理得到的数据并不是一个单纯的jsonarray数据，我们需要对他进行一个简单的提取操作：

var setting = {
    async: {
        enable: true,//采用异步加载
        dataFilter: ajaxDataFilter,    //预处理数据
        url : "http://127.0.0.1/WeChat/admin/C01Action_listC01.action",
        dataType : "json"
    },
    data : {
        key : {
            title : "c01name",    
            name : "c01name"
        },
        simpleData : {
            enable : true,
            idKey : "c01id",
            pIdKey : "c01parentid",
            rootPid : 000 
        }
    },
    callback : {
        beforeClick: zTreeBeforeClick,
        onClick : zTreeOnClick,
        onAsyncSuccess: zTreeOnAsyncSuccess //异步加载完成调用
    }
};
/* 获取返回的数据，进行预操作 */
function ajaxDataFilter(treeId, parentNode, responseData) {
    responseData = responseData.jsonArray;
    return responseData;
};
//异步加载完成时运行，此方法将所有的节点打开
function zTreeOnAsyncSuccess(event, treeId, msg) {
    var treeObj = $.fn.zTree.getZTreeObj("treeDemo");
    treeObj.expandAll(true);
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32
• 33
• 34
• 35

发起请求得到的数据包含一个jsonArray和一些其他字段，通过dataFilter先将数据处理一下，得到这个需要的json数据再做处理。 
在业务中可能会遇到要将所有节点打开的需求，这里有两种实现的方法，一种是在返回数据的时候，给父节点添加“open:true”字段；另一种方式是根据树的ID，打开它的所有节点，这里又分为静态和异步两种情况：

• 静态获取节点数据 
  根据树的ID直接打开所有子节点。
• 异步获取节点数据 
  利用回调函数，在树加载完成的时候调用方法，根据树的ID打开它的所有节点。

另附zTreeAPI文档地址：[http://www.treejs.cn/v3/api.php ]相当详细，点赞