Edit this page

Server Filtering

The Kendo UI AutoComplete, the ComboBox, the DropDownList and the MultiSelect widgets support server filtering.

You can use server filtering for displaying only a subset of data. Basically, the widget displays just the data returned from the server. You can use server filtering to display a subset of data, a reduced portion of the whole dataset. This functionality is convenient for you to apply when the end user cannot or does not want to see the whole dataset in the popup element.

Configuration

Server-filtering is based on the filtering capability of the DataSource component. You also need to be familiar with the filtering configuration of the component. For more information, refer to the DataSource serverFiltering option. Once you configure the DataSource to perform server filtering, you only need to additionally define the filter property of the widget.

For detailed information on how to configure the server filtering functionality, refer to the ComboBox server filtering demo.

Advantages

You can use the server-filtering feature to display only a subset of data. This is quite useful when the dataset is large and contains thousands or more records. In such situations, define a minimum filter length by using the minLength option. For instance, if you set this option to 3, the widget will not start filtering the dataset until at least 3 characters are entered.

Another benefit you gain from server filtering is the option to bind the widget to only one data item—the selected one. In this way, you avoid the need to retrieve the whole dataset when you want to display the selected value or text. This approach boosts the loading time of the widget. To apply this approach, send the selected value to the server and return only the matching data item. Use the data callback of the DataSource.

Example
    data: function() {
        //the selectedValue is used on the server to filter the source and return only the matching data item
        return {
            selectedValue: $("#[widget id]").data("kendoComboBox").value()
        }
    }

Known Limitations

The server filtering feature (as its name indicates) filters only the source. To page and filter the data set, use the Virtualization feature of the ComboBox.

See Also

Other articles on the Kendo UI ComboBox:

Is this article helpful? Yes / No
Thank you for your feedback!

Give article feedback

Tell us how we can improve this article

close
Dummy