-
Data Grid
- Overview
-
Data Binding
-
Paging and Scrolling
-
Editing
-
Grouping
-
Filtering and Sorting
- Focused Row
-
Row Drag & Drop
-
Selection
-
Columns
- State Persistence
-
Appearance
-
Templates
-
Data Summaries
-
Master-Detail
-
Export to PDF
-
Export to Excel
-
Adaptability
- Keyboard Navigation
-
Pivot Grid
- Overview
-
Data Binding
-
Field Chooser
-
Features
-
Export to Excel
-
Tree List
- Overview
-
Data Binding
- Sorting
- Paging
-
Editing
- Node Drag & Drop
- Focused Row
-
Selection
-
Filtering
-
Column Customization
- State Persistence
- Adaptability
- Keyboard Navigation
-
Scheduler
- Overview
-
Data Binding
-
Views
-
Features
- Virtual Scrolling
-
Grouping
-
Customization
- Adaptability
-
Html Editor
-
Chat
-
Diagram
- Overview
-
Data Binding
-
Featured Shapes
-
Custom Shapes
-
Document Capabilities
-
User Interaction
- UI Customization
- Adaptability
-
Charts
- Overview
-
Data Binding
-
Area Charts
-
Bar Charts
- Bullet Charts
-
Doughnut Charts
-
Financial Charts
-
Line Charts
-
Pie Charts
-
Point Charts
-
Polar and Radar Charts
-
Range Charts
-
Sparkline Charts
-
Tree Map
-
Funnel and Pyramid Charts
- Sankey Chart
-
Combinations
-
More Features
-
Export
-
Selection
-
Tooltips
-
Zooming
-
-
Gantt
- Overview
-
Data
-
UI Customization
- Strip Lines
- Export to PDF
- Sorting
-
Filtering
-
Gauges
- Overview
-
Data Binding
-
Bar Gauge
-
Circular Gauge
-
Linear Gauge
-
Navigation
- Overview
- Accordion
-
Menu
- Multi View
-
Drawer
-
Tab Panel
-
Tabs
-
Toolbar
- Pagination
-
Tree View
- Right-to-Left Support
-
Layout
-
Tile View
- Splitter
-
Gallery
- Scroll View
- Box
- Responsive Box
- Resizable
-
-
Editors
- Overview
- Autocomplete
-
Calendar
- Check Box
- Color Box
-
Date Box
-
Date Range Box
-
Drop Down Box
-
Number Box
-
Select Box
- Switch
-
Tag Box
- Text Area
- Text Box
- Validation
- Custom Text Editor Buttons
- Right-to-Left Support
- Editor Appearance Variants
-
Forms and Multi-Purpose
- Overview
- Button Group
- Field Set
-
Filter Builder
-
Form
- Radio Group
-
Range Selector
- Numeric Scale (Lightweight)
- Numeric Scale
- Date-Time Scale (Lightweight)
- Date-Time Scale
- Logarithmic Scale
- Discrete scale
- Custom Formatting
- Use Range Selection for Calculation
- Use Range Selection for Filtering
- Image on Background
- Chart on Background
- Customized Chart on Background
- Chart on Background with Series Template
- Range Slider
- Slider
-
Sortable
-
File Management
-
File Manager
- Overview
-
File System Types
-
Customization
-
File Uploader
-
-
Actions and Lists
- Overview
-
Action Sheet
-
Button
- Floating Action Button
- Drop Down Button
-
Context Menu
-
List
-
Lookup
-
Maps
- Overview
-
Map
-
Vector Map
-
Dialogs and Notifications
-
Localization
React Drop Down Box - Single Selection
DropDownBox is an advanced editor whose drop-down window can include other components.
DevExtreme ships with multiple other drop-down editors. To find out which editor best suits your task, review the following article: How to Choose a Drop-Down Editor.
To get started with the DevExtreme DropDownBox component, refer to the following step-by-step tutorial: Getting Started with DropDownBox.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
import React, { useCallback, useRef, useState } from 'react';
import DropDownBox, { DropDownBoxTypes } from 'devextreme-react/drop-down-box';
import TreeView, { TreeViewTypes } from 'devextreme-react/tree-view';
import DataGrid, {
Selection, Paging, FilterRow, Scrolling,
} from 'devextreme-react/data-grid';
import CustomStore from 'devextreme/data/custom_store';
import 'whatwg-fetch';
const gridColumns = ['CompanyName', 'City', 'Phone'];
const ownerLabel = { 'aria-label': 'Owner' };
const makeAsyncDataSource = (jsonFile: string) =>
new CustomStore({
loadMode: 'raw',
key: 'ID',
load() {
return fetch(`data/${jsonFile}`).then((response) => response.json());
},
});
const treeDataSource = makeAsyncDataSource('treeProducts.json');
const gridDataSource = makeAsyncDataSource('customers.json');
const gridBoxDisplayExpr = (item: { CompanyName: any; Phone: any }) =>
item && `${item.CompanyName} <${item.Phone}>`;
function App() {
const treeViewRef = useRef(null);
const [treeBoxValue, setTreeBoxValue] = useState('1_1');
const [gridBoxValue, setGridBoxValue] = useState([3]);
const [isGridBoxOpened, setIsGridBoxOpened] = useState(false);
const [isTreeBoxOpened, setIsTreeBoxOpened] = useState(false);
const treeViewItemSelectionChanged = useCallback(
(e: { component: { getSelectedNodeKeys: () => any } }) => {
setTreeBoxValue(e.component.getSelectedNodeKeys());
},
[],
);
const dataGridOnSelectionChanged = useCallback((e: { selectedRowKeys: any }) => {
setGridBoxValue(e.selectedRowKeys);
setIsGridBoxOpened(false);
}, []);
const treeViewOnContentReady = useCallback(
(e: TreeViewTypes.ContentReadyEvent) => {
e.component.selectItem(treeBoxValue);
},
[treeBoxValue],
);
const onTreeItemClick = useCallback(() => {
setIsTreeBoxOpened(false);
}, []);
const treeViewRender = useCallback(
() => (
<TreeView
dataSource={treeDataSource}
ref={treeViewRef}
dataStructure="plain"
keyExpr="ID"
parentIdExpr="categoryId"
selectionMode="single"
displayExpr="name"
selectByClick={true}
onContentReady={treeViewOnContentReady}
onItemClick={onTreeItemClick}
onItemSelectionChanged={treeViewItemSelectionChanged}
/>
),
[treeViewRef, treeViewOnContentReady, onTreeItemClick, treeViewItemSelectionChanged],
);
const dataGridRender = useCallback(
() => (
<DataGrid
dataSource={gridDataSource}
columns={gridColumns}
hoverStateEnabled={true}
showBorders={true}
selectedRowKeys={gridBoxValue}
onSelectionChanged={dataGridOnSelectionChanged}
height="100%"
>
<Selection mode="single" />
<Scrolling mode="virtual" />
<Paging
enabled={true}
pageSize={10}
/>
<FilterRow visible={true} />
</DataGrid>
),
[gridBoxValue, dataGridOnSelectionChanged],
);
const syncTreeViewSelection = useCallback((e: DropDownBoxTypes.ValueChangedEvent) => {
setTreeBoxValue(e.value);
if (!treeViewRef.current) return;
if (!e.value) {
treeViewRef.current.instance().unselectAll();
} else {
treeViewRef.current.instance().selectItem(e.value);
}
}, []);
const syncDataGridSelection = useCallback((e: DropDownBoxTypes.ValueChangedEvent) => {
setGridBoxValue(e.value);
}, []);
const onGridBoxOpened = useCallback((e: DropDownBoxTypes.OptionChangedEvent) => {
if (e.name === 'opened') {
setIsGridBoxOpened(e.value);
}
}, []);
const onTreeBoxOpened = useCallback((e: DropDownBoxTypes.OptionChangedEvent) => {
if (e.name === 'opened') {
setIsTreeBoxOpened(e.value);
}
}, []);
return (
<div className="dx-fieldset">
<div className="dx-field">
<div className="dx-field-label">DropDownBox with embedded TreeView</div>
<div className="dx-field-value">
<DropDownBox
value={treeBoxValue}
opened={isTreeBoxOpened}
valueExpr="ID"
inputAttr={ownerLabel}
displayExpr="name"
placeholder="Select a value..."
showClearButton={true}
dataSource={treeDataSource}
onValueChanged={syncTreeViewSelection}
onOptionChanged={onTreeBoxOpened}
contentRender={treeViewRender}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">DropDownBox with embedded DataGrid</div>
<div className="dx-field-value">
<DropDownBox
value={gridBoxValue}
opened={isGridBoxOpened}
valueExpr="ID"
deferRendering={false}
inputAttr={ownerLabel}
displayExpr={gridBoxDisplayExpr}
placeholder="Select a value..."
showClearButton={true}
dataSource={gridDataSource}
onValueChanged={syncDataGridSelection}
onOptionChanged={onGridBoxOpened}
contentRender={dataGridRender}
/>
</div>
</div>
</div>
);
}
export default App;
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
The following instructions show how to synchronize the DropDownBox with any other embedded DevExtreme component:
-
Specify data sources
The DropDownBox's and embedded component's data sources can be the same or different. If they are different, the embedded component's key field should be present in the DropDownBox's data source. -
Specify which data field provides the DropDownBox's values and the embedded component's keys
Assign the field's name to the DropDownBox's valueExpr property and to the key property of the embedded component's store. -
Synchronize the DropDownBox's value and the embedded component's selection
Bind the DropDownBox's value and the embedded component's selectedRowKeys/selectedItemKeys property to the same variable.