filters the component
| text | template|function | a template with the filtered value or a function |
| value | string | the filtering mask |
| preserve | boolean | if set to true, each next filtering criteria will be applied to the already filtered list |
// filters all fields with "abc" value in the "text" property
// using a template
list.filter("#text#","abc")
// using a function
list.filter(function(obj){
return obj.text.toString().indexOf("abc") != -1;
});
// unfilters the dataset
list.filter();
When called without parameters, the method unfilters the dataset.