XCheck为checkbox 全选/反选功能的 jquery插件,支持多页情况下保存已选项的情况。
- 引用jquery.js
- 引用XCheck.js
属性:
属性名 | 类型 | 默认值 | 说明 |
isKeep | boolean | false | 是否为【保持选择】的场景(比如ajax翻页多选) |
groupClass | string | ".xcheckgroup" | 【组】的class |
checkItemClass | string | ".checkItem" | 【要选择的每一项】的class |
checkAllClass | string | ".checkAll" | 【全选所有】的class |
checkAllCurrentClass | string | ".checkAllCurrent" | 【全选当页】的class |
clearCheckClass | string | ".clearCheck" | 【清空所有选择】的class |
clearCheckCurrentClass | string | ".clearCheckCurrent" | 【清空当页选择】的class |
reverseCheckCurrentClass | string | ".reverseCheckCurrent" | 【反选当页】的class |
valueClass | string | ".xcheckValue" | 【存放已选值】的class |
valueAttr | string | "value" | 【存放已选值】的属性 |
事件:
beforeCheckAll | function | function () { } | 【全选所有】前回调函数,如果返回false,则不执行默认的【全选所有】的事件 |
afterCheckAll | function | function () { } | 【全选所有】后的回调函数 |
beforeCheckAllCurrent | function | function () { } | 【全选当页】前的回调函数,如果返回false,则不执行默认的【全选当页】事件 |
afterCheckAllCurrent | function | function () { } | 【全选当页】后的回调函数 |
beforeCheckItem | function | function () { } | 【选择具体项】前回调函数,如果返回false,则不执行默认的【选择具体项】的事件 |
afterCheckItem | function | function () { } | 【选择具体项】后回调函数 |
beforeClearCheck | function | function () { } | 【清空选择所有】之前的回调函数,如果返回false,则不执行默认的【清空选择所有】的事件 |
afterClearCheck | function | function () { } | 【清空选择所有】之后的回调函数 |
beforeClearCheckCurrent | function | function () { } | 【清空选择当前页】之前的回调函数,如果返回false,则不执行默认的【清空选择当前页】的事件 |
afterClearCheckCurrent | function | function () { } | 【清空选择当前页】之后的回调函数 |
beforeReverseCheckCurrent | function | function () { } | 【反选当页】前的回调函数,如果返回false,则不执行默认的【反选当页】事件 |
afterReverseCheckCurrent | function | function () { } | 【反选当页】后的回调函数 |
公开方法
名称 | 说明 |
$.XCheck({...}).val(...) | 获取或设置结果值 |
$.XCheck({...}).initVal(...) | 根据指定的结果值,初始化插件状态 |
$.XCheck({...}).options | 获取当前的options |
isKeep==true时存放结果的SelectedBaseInfo对象:
属性名 | 类型 | 默认值 | 说明 |
isCheckAll | boolean | false | 是否全部保持已选状态 |
selectedValues | array | [] | 已选择项的值 |
unSelectedValues | array | [] | 未选择项的值 |
注:在线预览可能会不准确,请参考源码XCheck/demo.html