数据元素勾选(多选)功能接口

CheckInterface为视图组件添加了勾选(多选)功能

将组件的checkbox_visible属性设置为true以启用勾选, 数据和视图组件通过checkable属性控制数据是否可以被勾选, Tree/Grid/ListView等通用组件实现了CheckInterface

isCheckable(data)数据元素是否可被勾选回调函数

默认返回数据元素的checkable属性, 可以重载以自定义勾选规则

dataz.Data要检查的的数据元素

checkableboolean如果返回true, 则表示数据元素可被勾选, 否则表示数据不可被勾选

                    
                        var list = new z.widget.ListView({
                            checkbox_visible: true,  //授权
                            isCheckable: function (data) {
                                return data.get("age") > 10; // 只有age大于10的data可以被勾选.
                            }
                        })

check(data, isAdd)勾选(多选)数据元素

dataz.Data|object|array要勾选的数据元素, 可以是z.Data实例、object对象或两者数组
isAddboolean以累加的方式还是替换的方式设置勾选数据, 如果为true为累加, 否则为替换, 默认为false(替换)

                    
                        var data1 = new z.Data({name: "data1"});
                        var data2 = new z.Data({name: "data2"});
                        var data3 = new z.Data({name: "data3"});
                        var listView = z.widget.ListView({
                             appendTo: "#listDiv",
                             checkbox_visible: true,
                             data: [data1, data2, data3]
                        });
                        listView.check(data1);          //data1 is checked;
                        listView.check([data2, data3]); //[data2,data3] are checked, data1 is unchecked
                        listView.check(data1, true);    //[data1,data2,data3] are checked

uncheck(data)取消勾选数据元素

dataz.Data|object|array取消勾选的数据元素, 可以是z.Data实例、object对象或两者数组

                    
                        var data1 = new z.Data({name: "data1"});
                        var data2 = new z.Data({name: "data2"});
                        var data3 = new z.Data({name: "data3"});
                        var listView = z.widget.ListView({
                            appendTo: "#listDiv",
                            checkbox_visible: true,
                            data: [data1, data2, data3]
                        });
                        listView.check([data1, data2]); //[data1,data2] are checked;
                        listView.uncheck(data1);        //only data2 checked

clearCheck()清除所有勾选数据

                
                    var data1 = new z.Data({name: "data1"});
                    var data2 = new z.Data({name: "data2"});
                    var data3 = new z.Data({name: "data3"});
                    var listView = z.widget.ListView({
                        appendTo: "#listDiv",
                        checkbox_visible: true,
                        data: [data1, data2, data3]
                    });
                    listView.check([data1, data2]); //[data1,data2] are checked;
                    listView.clearCheck();          //no checked data

checkAll(onlyVisible)勾选所有数据元素

onlyVisibleboolean是否只勾选当前可见数据元素, 如果为false, 勾选所有数据, 否则只勾选当前可见数据, 默认为true(可见数据)

                    
                        var data1 = new z.Data({name: "data1"});
                        var data2 = new z.Data({name: "data2", visible: false});    // data2 is not visible.
                        var data3 = new z.Data({name: "data3"});
                        var listView = z.widget.ListView({
                            appendTo: "#listDiv",
                            checkbox_visible: true,
                            data: [data1, data2, data3]
                        });
                        listView.checkAll();            // data2 is not checked
                        listView.checkAll(false);       // data2 is checked

getChecked()返回所有已勾选数据列表

checkedArrayarray所有已勾选数据列表

                    
                        var data1 = new z.Data({name: "data1"});
                        var data2 = new z.Data({name: "data2"});
                        var data3 = new z.Data({name: "data3"});
                        var listView = z.widget.ListView({
                            appendTo: "#listDiv",
                            checkbox_visible: true,
                            data: [data1, data2, data3]
                        });
                        listView.checkAll();
                        console.log(listView.getChecked());  //[data1,data2,data3]

isChecked(data)检查数据是否为被勾选状态

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

checkedboolean如果数据选素被勾选, 返回true, 否则返回false

                    
                        var data1 = new z.Data({name: "data1"});
                        var data2 = new z.Data({name: "data2"});
                        var data3 = new z.Data({name: "data3"});
                        var listView = z.widget.ListView({
                            appendTo: "#listDiv",
                            checkbox_visible: true,
                            data: [data1, data2, data3]
                        });
                        listView.check([data1, data2]);
                        console.log(listView.isChecked(data1));  //true
                        console.log(listView.isChecked(data3));  //false

onCheckChange(listener, thisArg)添加数据勾选变化事件监听

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

                  
                    view.onCheckChange(function (evt) {
                        console.log(evt.type);  // type: add/remove/clear/set
                        console.log(evt.data);  // data
                    });