DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Overview

The SelectBox component allows users to select an item from a drop-down list.

DevExtreme Accessibility Compliance
DevExtreme component libraries meet a variety of WCAG and Section 508 compliance standards. To assess this demo’s accessibility level, click the Run AXE® Validation button to launch the AXE® web accessibility evaluation tool.
All trademarks or registered trademarks are property of their respective owners. AXE® Terms of Use
The overall accessibility level of your application depends on the SelectBox features used.
Backend API
import React, { useCallback, useState } from 'react'; import SelectBox, { SelectBoxTypes } from 'devextreme-react/select-box'; import ArrayStore from 'devextreme/data/array_store'; import notify from 'devextreme/ui/notify'; import service from './data.ts'; import Field from './Field.tsx'; import Item from './Item.tsx'; const simpleProductLabel = { 'aria-label': 'Simple Product' }; const productIDLabel = { 'aria-label': 'Product ID' }; const productWithPlaceholderLabel = { 'aria-label': 'Product With Placeholder' }; const productLabel = { 'aria-label': 'Product' }; const readOnlyProductLabel = { 'aria-label': 'ReadOnly Product' }; const templatedProductLabel = { 'aria-label': 'Templated Product' }; const disabledProductLabel = { 'aria-label': 'Disabled Product' }; const products = service.getProducts(); const simpleProducts = service.getSimpleProducts(); const data = new ArrayStore({ data: products, key: 'ID', }); function App() { const [value, setValue] = useState(service.getSimpleProducts()[0]); const onValueChanged = useCallback((e: SelectBoxTypes.ValueChangedEvent) => { setValue(e.value); notify(`The value is changed to: "${e.value}"`); }, []); return ( <div> <div className="dx-fieldset"> <div className="dx-field"> <div className="dx-field-label">Default mode</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} inputAttr={simpleProductLabel} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">With a custom placeholder</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} placeholder="Choose Product" inputAttr={productWithPlaceholderLabel} showClearButton={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Read only</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} defaultValue={simpleProducts[0]} inputAttr={readOnlyProductLabel} readOnly={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Disabled</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} inputAttr={disabledProductLabel} defaultValue={simpleProducts[0]} disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Data source usage</div> <div className="dx-field-value"> <SelectBox dataSource={data} displayExpr="Name" inputAttr={productIDLabel} valueExpr="ID" defaultValue={products[0].ID} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Custom templates</div> <div className="dx-field-value"> <SelectBox id="custom-templates" dataSource={products} displayExpr="Name" inputAttr={templatedProductLabel} valueExpr="ID" defaultValue={products[3].ID} fieldRender={Field} itemRender={Item} /> </div> </div> </div> <div className="dx-fieldset"> <div className="dx-fieldset-header">Event Handling</div> <div className="dx-field"> <div className="dx-field-label">Product</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} value={value} inputAttr={productLabel} onValueChanged={onValueChanged} /> </div> </div> <div className="current-value"> Selected product is <span>{value}</span> </div> </div> </div> ); } export default App;
import React, { useCallback, useState } from 'react'; import SelectBox from 'devextreme-react/select-box'; import ArrayStore from 'devextreme/data/array_store'; import notify from 'devextreme/ui/notify'; import service from './data.js'; import Field from './Field.js'; import Item from './Item.js'; const simpleProductLabel = { 'aria-label': 'Simple Product' }; const productIDLabel = { 'aria-label': 'Product ID' }; const productWithPlaceholderLabel = { 'aria-label': 'Product With Placeholder' }; const productLabel = { 'aria-label': 'Product' }; const readOnlyProductLabel = { 'aria-label': 'ReadOnly Product' }; const templatedProductLabel = { 'aria-label': 'Templated Product' }; const disabledProductLabel = { 'aria-label': 'Disabled Product' }; const products = service.getProducts(); const simpleProducts = service.getSimpleProducts(); const data = new ArrayStore({ data: products, key: 'ID', }); function App() { const [value, setValue] = useState(service.getSimpleProducts()[0]); const onValueChanged = useCallback((e) => { setValue(e.value); notify(`The value is changed to: "${e.value}"`); }, []); return ( <div> <div className="dx-fieldset"> <div className="dx-field"> <div className="dx-field-label">Default mode</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} inputAttr={simpleProductLabel} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">With a custom placeholder</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} placeholder="Choose Product" inputAttr={productWithPlaceholderLabel} showClearButton={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Read only</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} defaultValue={simpleProducts[0]} inputAttr={readOnlyProductLabel} readOnly={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Disabled</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} inputAttr={disabledProductLabel} defaultValue={simpleProducts[0]} disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Data source usage</div> <div className="dx-field-value"> <SelectBox dataSource={data} displayExpr="Name" inputAttr={productIDLabel} valueExpr="ID" defaultValue={products[0].ID} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Custom templates</div> <div className="dx-field-value"> <SelectBox id="custom-templates" dataSource={products} displayExpr="Name" inputAttr={templatedProductLabel} valueExpr="ID" defaultValue={products[3].ID} fieldRender={Field} itemRender={Item} /> </div> </div> </div> <div className="dx-fieldset"> <div className="dx-fieldset-header">Event Handling</div> <div className="dx-field"> <div className="dx-field-label">Product</div> <div className="dx-field-value"> <SelectBox items={simpleProducts} value={value} inputAttr={productLabel} onValueChanged={onValueChanged} /> </div> </div> <div className="current-value"> Selected product is <span>{value}</span> </div> </div> </div> ); } export default App;
import React from 'react'; import TextBox from 'devextreme-react/text-box'; const nameLabel = { 'aria-label': 'Name' }; export default function Field(data: { ImageSrc: any; Name: any }) { return ( <div className="custom-item"> <img alt="Product name" src={data && data.ImageSrc} /> <TextBox className="product-name" inputAttr={nameLabel} defaultValue={data && data.Name} readOnly={true} /> </div> ); }
import React from 'react'; export default function Item(data) { return ( <div className="custom-item"> <img alt="Product name" src={data.ImageSrc} /> <div className="product-name">{data.Name}</div> </div> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render(<App />, document.getElementById('app'));
const 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', ]; const 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', }]; export default { getSimpleProducts() { return simpleProducts; }, getProducts() { return products; }, };
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@24.1.3/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.3/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.8/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.13/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; import TextBox from 'devextreme-react/text-box'; const nameLabel = { 'aria-label': 'Name' }; export default function Field(data) { return ( <div className="custom-item"> <img alt="Product name" src={data && data.ImageSrc} /> <TextBox className="product-name" inputAttr={nameLabel} defaultValue={data && data.Name} readOnly={true} /> </div> ); }
import React from 'react'; export default function Item(data) { return ( <div className="custom-item"> <img alt="Product name" src={data.ImageSrc} /> <div className="product-name">{data.Name}</div> </div> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
const 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', ]; const 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', }, ]; export default { getSimpleProducts() { return simpleProducts; }, getProducts() { return products; }, };
<!DOCTYPE html> <html lang="en"> <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=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.3/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>
/* stylelint-disable indentation */ /* stylelint-disable selector-descendant-combinator-no-non-space */ .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; } .dx-theme-material #custom-templates .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; }

This demo illustrates the following SelectBox properties:

  • 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 SelectBox responds to user interaction.
  • dataSource
    Binds the SelectBox to data. Unlike the items property, 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.

To get started with the DevExtreme SelectBox component, refer to the following tutorial for step-by-step instructions: Getting Started with SelectBox.