Overview

The SelectBox widget is an editor that allows an end user to select an item from a drop-down list.

View Demo

The following code adds the SelectBox to your page. The simplest configuration of the widget requires only a dataSource to be specified. In addition, you can specify the placeholder to be displayed when the SelectBox is empty.

HTML
<div id="selectBoxContainer"></div>
JavaScript
$(function() {
    $("#selectBoxContainer").dxSelectBox({
        dataSource: [
            "HD Video Player",
            "SuperHD Video Player",
            "SuperPlasma 50",
            // . . .
        ],
        placeholder: "Select a product..."
    });
});

If your data is an array of objects, specify:

  • valueExpr
    The data field whose value will be written into the value option.
  • displayExpr
    The data field whose value will be displayed in the drop-down list and in the input field of the widget.
JavaScript
var selectBoxData = [
    { id: 1, country: "Afghanistan" },
    { id: 2, country: "Albania" },
    // . . .
];

$(function() {
    $("#selectBoxContainer").dxSelectBox({
        dataSource: selectBoxData,
        valueExpr: 'id',
        displayExpr: 'country'
    });
});
See Also