首页 > 代码库 > kendo grid的过滤filter

kendo grid的过滤filter

  kendo是一套强大方便的前端解决方案,而且新版还可以与angularjs集成,项目中就使用了一些kendo的控件,比如grid表格。

  grid提供了过滤功能,但中文网站缺少这方面的资料,在这里整理一下kendo grid怎么使用过滤。

  下面代码包含了grid的过滤所有涉及的所有设置,以这个完整的例子,加上注释讲解其使用方法:

  1 <div id="grid"></div>  2 <script>  3     $("#grid").kendoGrid({  4         columns: [  5             {  6                 field: "name",  7                 //filterable对象,过虑功能的总开关,值为true时开启,默认值为true,只针对当前列  8                 filterable: {  9                     //过滤显示的单元格,只有当mode的值为row时才可用 10                     cell: { 11                         enabled: true,//是否可用的开关 12  13                         //自动完成数据源 14                         dataSource: new kendo.data.DataSource({ 15                             data: [ 16                                 { someField: "Jane" }, 17                                 { someField: "Jake" }, 18                                 { someField: "John" } 19                             ] 20                         }), 21                         dataTextField: "someField",//自动完成要显示的数据源列,与上面配合使用 22                         delay: 1500,//自动完成激活的时间延迟 23                         minLength: 3,//自动完成激活的最少字符数,当该格式为string时 24                         suggestionOperator: "contains",//自动完成选择时的默认操作 25  26                         inputWidth: 100,//条件输入框的宽度,受所在列宽限制 27  28                         showOperators: false,//是否显示过滤按钮 29                         operator: "contains",//过滤按钮的默认操作 30                         //过滤的显示模板,element是过滤单元格,在里面加其他元素,dataSource是grid的dataSource,但是只包含数据,不像在grid中使用时带有自动赋予的唯一值,自动完成也是可以使用的 31                         template: function (args) { 32                             // create a DropDownList of unique values (colors) 33                             args.element.kendoDropDownList({ 34                                 dataSource: args.dataSource, 35                                 dataTextField: "color", 36                                 dataValueField: "color", 37                                 valuePrimitive: true 38                             }); 39                             // or 40                             // create a ColorPicker 41                             // args.element.kendoColorPicker(); 42                         }, 43                         //是一个方法function,或者kendo的组件 44                         ui: "datetimepicker" // use Kendo UI DateTimePicker 45                         //ui: function (element) { 46                         //    element.kendoDateTimePicker(); // initialize a Kendo UI DateTimePicker 47                         //} 48                     } 49                 } 50             }, 51             { field: "age" } 52         ], 53         //filterable对象,过虑功能的总开关,值为true时开启,默认值为false,控制所有列 54         filterable: { 55             extra: false,//是否双过滤条件,默认为true 56             //过滤弹窗上显示的文字,都是可定制的 57             messages: { 58                 info: "Filter by: ",//顶端提示信息 59                 and: "and", 60                 or: "or", 61                 filter: "Apply filter",//过滤按钮 62                 clear: "Clear filter",//清空按钮 63  64                 isFalse: "False",//过滤条件radio按钮的显示文字,当field设置type: "boolean"时,可设此值 65                 isTrue: "True",//同上 66  67                 selectValue: "-Select value-",//过滤条件下拉按钮dropdownlist首项的显示文字,当field的值为枚举型时,设置values: [{ text: Beverages", value: 1 },{ text: "Food", value: 2 },],可设此值 68  69                 cancel: "Cancel",//返回按钮的显示文字,只有当grid的option设置mobile: "phone"时,可设此值 70                 operator: "Operator",//选择操作前标签的显示文字,条件与上同 71                 value: "Value",//值输入前标签的显示文字,条件与上同 72  73                 //条件运算符的显示文字,具体使用取决于field设置的type 74                 operators: { 75                     //字符串型 76                     string: { 77                         eq: "Is equal to", 78                         neq: "Is not equal to", 79                         startswith: "Starts with", 80                         contains: "Contains", 81                         doesnotcontain: "Doesn‘t contain", 82                         endswith: "Ends" 83                     }, 84                     //数值型 85                     number: { 86                         eq: "Equal to", 87                         neq: "Not equal to", 88                         gte: "Greater than or equal to",//大于等于 89                         gt: "Greater than",//大于 90                         lte: "Less than or equal to",//小于等于 91                         lt: "Less than"//小于 92                     }, 93                     //日期型 94                     date: { 95                         gt: "After", 96                         lt: "Before", 97                         eq: "Equal", 98                         neq: "Not equal", 99                         gte: "After or equal to",100                         lte: "Before or equal to"101                     },102                     //枚举型,103                     enums: {104                         eq: "Equal to",105                         neq: "Not equal to"106                     }107                 },108 109                 mode: "menu"//过滤的显示方式,可选值有"row"、"menu"、"menu, row",row是标题行下加过滤单元格,menu是菜单110             }111         },112         dataSource: [113             { name: "Jane Doe", age: 30 },114             { name: "John Doe", age: 33 }115         ]116     });117 </script>

 

  上面代码可以出,grid的过滤主要加在columns和filterable中,columns可对每列进行单独控制,而filterable则对所有列进行控制。

  向后台传递过滤条件时,在grid option设置的getData方法中第一个参数中带有过滤条件,可在向后台传递前进行其他操作。

kendo grid的过滤filter