Overview
The SelectBox widget allows users to select an item from a drop-down list. This demo illustrates the following SelectBox options:
- items
Specifies an array of items displayed in the SelectBox. - placeholder
Specifies the text that is displayed when no items are selected. - readOnly
Prevents users from changing the editor's value via the UI. - disabled
Specifies whether the widget responds to user interaction. - dataSource
Binds the widget to data. Unlike the items option, dataSource accepts the DataSource object that allows users to sort, filter, group, and shape data. - fieldTemplate and itemTemplate
Allow you to customize the text field and drop-down list items. - onValueChanged event handler
Use this function to perform an action when a user chooses a new value. In this demo, this function is used to display the selected value.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
window.onload = function() {
var currentProduct = ko.observable(simpleProducts[0]);
var viewModel = {
currentProduct: currentProduct,
simple: {
items: simpleProducts
},
withCustomPlaceholder: {
items: simpleProducts,
placeholder: "Choose Product",
showClearButton: true
},
readOnly: {
items: simpleProducts,
value: simpleProducts[0],
readOnly: true
},
disabled: {
items: simpleProducts,
value: simpleProducts[0],
disabled: true
},
dataSourceUsage: {
dataSource: new DevExpress.data.ArrayStore({
data: products,
key: "ID"
}),
displayExpr: "Name",
valueExpr: "ID",
value: products[0].ID
},
customTemplates: {
dataSource: products,
displayExpr: "Name",
valueExpr: "ID",
value: products[3].ID,
fieldTemplate: "field"
},
eventHandler: {
items: simpleProducts,
value: currentProduct
}
};
ko.applyBindings(viewModel, document.getElementById("select-box-demo"));
};
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>DevExtreme Demo</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" />
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
<script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/knockout/3.4.2/knockout-min.js"></script>
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.3/css/dx.light.css" />
<script src="https://cdn3.devexpress.com/jslib/20.2.3/js/dx.all.js"></script>
<script src="data.js"></script>
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="index.js"></script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="select-box-demo" class="form">
<div class="dx-fieldset">
<div class="dx-field">
<div class="dx-field-label">Default mode</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: simple"></div>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">With a custom placeholder</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: withCustomPlaceholder"></div>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Read only</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: readOnly"></div>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Disabled</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: disabled"></div>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Data source usage</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: dataSourceUsage"></div>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Custom templates</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: customTemplates">
<div data-options="dxTemplate: { name: 'field' }">
<div class="custom-item">
<img data-bind="attr:{src: ImageSrc}"/>
<div class="product-name" data-bind="dxTextBox: {value: $data.Name, readOnly: true }">
</div>
</div>
</div>
<div data-options="dxTemplate: { name: 'item' }">
<div class="custom-item">
<img data-bind="attr:{src: ImageSrc}"/>
<div class="product-name" data-bind="text:Name">
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="dx-fieldset">
<div class="dx-fieldset-header">Event Handling</div>
<div class="dx-field">
<div class="dx-field-label">Product</div>
<div class="dx-field-value">
<div data-bind="dxSelectBox: eventHandler"></div>
</div>
</div>
<div class="current-value">
Selected product is <span data-bind="text: currentProduct"></span>
</div>
</div>
</div>
</div>
</body>
</html>
.dx-dropdownlist-popup-wrapper .dx-list:not(.dx-list-select-decorator-enabled) .dx-list-item-content {
padding-left: 7px;
padding-right: 7px;
}
.custom-item {
position: relative;
min-height: 30px;
}
.dx-dropdowneditor-input-wrapper .custom-item > img {
padding-left: 8px;
}
.custom-item .product-name {
display: inline-block;
padding-left: 50px;
text-indent: 0;
line-height: 30px;
font-size: 15px;
width: 100%;
}
.custom-item > img {
left: 1px;
position: absolute;
top: 50%;
margin-top: -15px;
}
.custom-item .dx-texteditor-buttons-container {
display: none;
}
.current-value {
padding: 10px 0;
}
.current-value > span {
font-weight: bold;
}
.dx-theme-material .dx-selectbox-container .product-name {
padding-left: 58px;
}
var simpleProducts = [
"HD Video Player",
"SuperHD Video Player",
"SuperPlasma 50",
"SuperLED 50",
"SuperLED 42",
"SuperLCD 55",
"SuperLCD 42",
"SuperPlasma 65",
"SuperLCD 70",
"Projector Plus",
"Projector PlusHT",
"ExcelRemote IR",
"ExcelRemote BT",
"ExcelRemote IP"
];
var products = [{
"ID": 1,
"Name": "HD Video Player",
"Price": 330,
"Current_Inventory": 225,
"Backorder": 0,
"Manufacturing": 10,
"Category": "Video Players",
"ImageSrc": "../../../../images/products/1-small.png"
}, {
"ID": 2,
"Name": "SuperHD Player",
"Price": 400,
"Current_Inventory": 150,
"Backorder": 0,
"Manufacturing": 25,
"Category": "Video Players",
"ImageSrc": "../../../../images/products/2-small.png"
}, {
"ID": 3,
"Name": "SuperPlasma 50",
"Price": 2400,
"Current_Inventory": 0,
"Backorder": 0,
"Manufacturing": 0,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/3-small.png"
}, {
"ID": 4,
"Name": "SuperLED 50",
"Price": 1600,
"Current_Inventory": 77,
"Backorder": 0,
"Manufacturing": 55,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/4-small.png"
}, {
"ID": 5,
"Name": "SuperLED 42",
"Price": 1450,
"Current_Inventory": 445,
"Backorder": 0,
"Manufacturing": 0,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/5-small.png"
}, {
"ID": 6,
"Name": "SuperLCD 55",
"Price": 1350,
"Current_Inventory": 345,
"Backorder": 0,
"Manufacturing": 5,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/6-small.png"
}, {
"ID": 7,
"Name": "SuperLCD 42",
"Price": 1200,
"Current_Inventory": 210,
"Backorder": 0,
"Manufacturing": 20,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/7-small.png"
}, {
"ID": 8,
"Name": "SuperPlasma 65",
"Price": 3500,
"Current_Inventory": 0,
"Backorder": 0,
"Manufacturing": 0,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/8-small.png"
}, {
"ID": 9,
"Name": "SuperLCD 70",
"Price": 4000,
"Current_Inventory": 95,
"Backorder": 0,
"Manufacturing": 5,
"Category": "Televisions",
"ImageSrc": "../../../../images/products/9-small.png"
}, {
"ID": 10,
"Name": "DesktopLED 21",
"Price": 175,
"Current_Inventory": 0,
"Backorder": 425,
"Manufacturing": 75,
"Category": "Monitors",
"ImageSrc": "../../../../images/products/10-small.png"
}, {
"ID": 11,
"Name": "DesktopLED 19",
"Price": 165,
"Current_Inventory": 425,
"Backorder": 0,
"Manufacturing": 110,
"Category": "Monitors",
"ImageSrc": "../../../../images/products/11-small.png"
}, {
"ID": 12,
"Name": "DesktopLCD 21",
"Price": 170,
"Current_Inventory": 210,
"Backorder": 0,
"Manufacturing": 60,
"Category": "Monitors",
"ImageSrc": "../../../../images/products/12-small.png"
}, {
"ID": 13,
"Name": "DesktopLCD 19",
"Price": 160,
"Current_Inventory": 150,
"Backorder": 0,
"Manufacturing": 210,
"Category": "Monitors",
"ImageSrc": "../../../../images/products/13-small.png"
}, {
"ID": 14,
"Name": "Projector Plus",
"Price": 550,
"Current_Inventory": 0,
"Backorder": 55,
"Manufacturing": 10,
"Category": "Projectors",
"ImageSrc": "../../../../images/products/14-small.png"
}, {
"ID": 15,
"Name": "Projector PlusHD",
"Price": 750,
"Current_Inventory": 110,
"Backorder": 0,
"Manufacturing": 90,
"Category": "Projectors",
"ImageSrc": "../../../../images/products/15-small.png"
}, {
"ID": 16,
"Name": "Projector PlusHT",
"Price": 1050,
"Current_Inventory": 0,
"Backorder": 75,
"Manufacturing": 57,
"Category": "Projectors",
"ImageSrc": "../../../../images/products/16-small.png"
}, {
"ID": 17,
"Name": "ExcelRemote IR",
"Price": 150,
"Current_Inventory": 650,
"Backorder": 0,
"Manufacturing": 190,
"Category": "Automation",
"ImageSrc": "../../../../images/products/17-small.png"
}, {
"ID": 18,
"Name": "ExcelRemote BT",
"Price": 180,
"Current_Inventory": 310,
"Backorder": 0,
"Manufacturing": 0,
"Category": "Automation",
"ImageSrc": "../../../../images/products/18-small.png"
}, {
"ID": 19,
"Name": "ExcelRemote IP",
"Price": 200,
"Current_Inventory": 0,
"Backorder": 325,
"Manufacturing": 225,
"Category": "Automation",
"ImageSrc": "../../../../images/products/19-small.png"
}];