Enable Searching

The SelectBox widget allows an end user to search through its items. By default, this feature is disabled. To enable it, assign true to the searchEnabled option. To specify which data fields should be searched, use the searchExpr option. If you need to search several fields, assign an array of field names to this option.

JavaScript
var selectBoxData = [
    { id: 1, country: "Afghanistan", capital: "Kabul" },
    { id: 2, country: "Albania", capital: "Tirana" },
    // . . .
];

$(function() {
    $("#selectBoxContainer").dxSelectBox({
        dataSource: selectBoxData,
        valueExpr: 'id',
        displayExpr: 'country',
        searchEnabled: true,
        searchExpr: ['country', 'capital']
    });
});

View Demo

By default, when a user types a string in the input field, the SelectBox suggests all items that contain this string. If you want the SelectBox to suggest only those items that start with the input string, assign 'startswith' to the searchMode option.

JavaScript
$(function() {
    $("#selectBoxContainer").dxSelectBox({
        dataSource: selectBoxData,
        valueExpr: 'id',
        displayExpr: 'country',
        searchEnabled: true,
        searchExpr: 'country',
        searchMode: 'startswith'
    });
});

There is a delay between the moment a user finishes typing and the moment the search is executed. To increase or descrease it, use the searchTimeout option. The delay is measured in milliseconds.

JavaScript
$(function() {
    $("#selectBoxContainer").dxSelectBox({
        dataSource: selectBoxData,
        valueExpr: 'id',
        displayExpr: 'country',
        searchEnabled: true,
        searchExpr: 'country',
        searchTimeout: 1000
    });
});

By default, the SelectBox widget starts searching after a user has typed at least one character. To increase the number of characters that triggers the search, use the minSearchLength option.

JavaScript
$(function() {
    $("#selectBoxContainer").dxSelectBox({
        dataSource: selectBoxData,
        valueExpr: 'id',
        displayExpr: 'country',
        searchEnabled: true,
        searchExpr: "country",
        minSearchLength: 3
    });
});
See Also