数据操作接口

• dataarray|object数据, 可以是数组或者对象

                    
                        view.setData([
                            {name: "data1"},
                            {name: "data2"}
                        ])
                    
                

• dataobject|array|z.Data添加的数据, 可以是对象、数组或z.Data实例
• indexNumber插入数据的位置索引

                    
                        view.addData({name:"focus-ui"});                //对象
                        view.addData({name:"focus-ui"},0);              //在位置0插入数据
                        view.addData([{name:"data1"},{name:"data2"}]);  //多个对象数组
                        view.addData(new z.Data({name:"focus-ui"}));    //z.Data
                    
                

• dataobject|array|z.Data要删除的数据, 可以是对象、数组或z.Data实例

                    
                        view.removeData({name: "focus-ui"});
                        view.removeData([{name: "data1"}, {name: "data2"}]);
                    
                

                    
                        view.clearData();
                    
                

• dataobject|z.Data要检查的数据, 可以是属性对象或z.Data实例

• is_containedboolean如果包含指定数据返回true, 否则返回false

                    
                        view.containsData({name:"data"})    //object
                        view.containsData(aData)            //z.Data
                    
                

• propstring|object|function指定的属性名称, 也可以是对象或函数, 如果prop是对象或函数, value参数将被忽略
• value*指定的值

• dataz.Data匹配指定条件的第一个数据；否则, 返回undefined

                    
                        view.findData("name", "focus-ui");          // name为"focus-ui"的数据
                        view.findData({                             // name为"focus-ui"并且version为2.0的数据
                            name: "focus-ui",
                            version: 2.0
                        });
                        view.findData(function (data) {
                            return data.get("name")==="focus-ui";   // name为"focus-ui"的数据
                        })
                    
                

• propstring|object|function指定的属性名称, 也可以对象或函数, 如果是对象或函数, value参数将被忽略
• value*指定的值

• dataArrayarray与指定条件匹配的所有数据

                    
                        view.filterData("type","node");           //所有的type为"node"的数据
                        view.filterData({                         //所有的type为"node"并且shape为"circle"的数据
                            type:"node",
                            shape:"circle"
                        });
                        view.filterData(function (data) {
                            return data.get("type")==="node";     //所有的type为"node"的数据
                        })
                    
                

• dataArrayarray包含所有数据的数组

                    
                        var arr = view.getDataArray();
                    
                

• sizenumber所有数据的数量

                    
                        var count = view.getDataSize();
                    
                

• callbackfunction对每个数据执行的回调函数, 回调函数返回false会中断循环, 有两个参数
  • currentDataz.Data当前遍历的数据
  • indexnumber当前遍历数据的索引
• thisArgobject执行回调函数时this指向的对象

                    
                        var nameArr = [];
                        view.eachData(function (data) {
                            nameArr.push(data.get("name"));
                        });
                        var hasGroup = false;
                        view.eachData(function (data,index) {
                            if (data.get("type") === "group") {
                                  hasGroup = true;
                                  return false;
                            }
                        });
                    
                

• callbackfunction对每个数据执行的回调函数, 回调函数返回false会中断循环, 参数为
  • currentDataz.Data当前遍历的数据
• thisArgobject执行回调函数时this指向的对象

                    
                        var nameArr = [];
                        view.hEachData(function (data) {
                            nameArr.push(data.get("name"));
                        });
                    
                

• rootDataArrarray所有根数据列表

                    
                        var rootDataArr = view.getRootDataArray();
                    
                

监听的事件类型如下

• 数据增删改操作
• 设置数据操作
• 数据属性变化

• listenerfunction数据变化事件监听函数
• thisArgobject执行监听函数时this指向的对象

                    
                        view.onModelChange(function (evt) {
                            console.log(evt.type,evt.event);
                        });
                        var aData = new z.Data();
                        view.setData([new z.Data(), new z.Data()]);     //type:set_provider
                        view.addData(aData);                            //type:provider
                        aData.set("name", "abc");                       //type:data
                        view.removeData(aData);                         //type:provider
                    
                

• listenerfunction要移除的数据变化事件监听函数
• thisArgobject执行监听函数时this指向的对象

                    
                        view.offModelChange(addedListener);
                    
                

listener和thisArg必须和onModelChange添加时的完全一致, 事件监听才会被移除