Customize Drop-Down Button
Use the dropDownButtonTemplate to customize the drop-down button. This demo illustrates three customization cases:
-
Custom image
Declare animgelement in the template. -
Load indicator
Declare the load indicator and a regular icon in the template. Display the load indicator while hiding the icon, and vice versa. -
Icon that depends on the selected value
Declare the default and the selected item's icon in the template. If there is a selected item, display its icon; otherwise, show the default icon.
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.
import React from 'react';
import SelectBox from 'devextreme-react/select-box';
import { products, simpleProducts } from './data.js';
import ImageIcon from './imageIcon.js';
import IndicatorIcon from './indicatorIcon.js';
import ConditionalIcon from './conditionalIcon.js';
import Item from './item.js';
import { Template } from 'devextreme-react/core/template';
class App extends React.Component {
constructor(props) {
super(props);
this.deferredProducts = {
loadMode: 'raw',
load: () => {
this.setState({ isLoaded: false });
var promise = new Promise((resolve) => {
setTimeout(() => {
resolve(simpleProducts);
this.setState({ isLoaded: true });
}, 3000);
});
return promise;
}
};
this.state = {
selectedItem: products[0],
isLoaded: true
};
this.renderLoadIndicator = this.renderLoadIndicator.bind(this);
this.renderConditionalIcon = this.renderConditionalIcon.bind(this);
this.selectionChanged = this.selectionChanged.bind(this);
}
render() {
return (
<div className='dx-fieldset'>
<div className='dx-field'>
<div className='dx-field-label'>Image as the icon</div>
<div className='dx-field-value'>
<SelectBox dataSource={simpleProducts}
dropDownButtonRender={ImageIcon} />
</div>
</div>
<div className='dx-field'>
<div className='dx-field-label'>Load indicator as the icon</div>
<div className='dx-field-value'>
<SelectBox dataSource={this.deferredProducts}
dropDownButtonTemplate='loadIndicator'>
<Template name='loadIndicator' render={this.renderLoadIndicator} />
</SelectBox>
</div>
</div>
<div className='dx-field'>
<div className='dx-field-label'>Value-dependent icon</div>
<div className='dx-field-value'>
<SelectBox dataSource={products}
defaultValue={products[0].ID}
selectedItem={this.state.selectedItem}
displayExpr='Name'
showClearButton={true}
valueExpr='ID'
itemRender={Item}
dropDownButtonTemplate='conditionalIcon'
onSelectionChanged={this.selectionChanged}
>
<Template name='conditionalIcon' render={this.renderConditionalIcon} />
</SelectBox>
</div>
</div>
</div>
);
}
renderLoadIndicator() {
return <IndicatorIcon isLoaded={this.state.isLoaded} />;
}
renderConditionalIcon() {
return <ConditionalIcon value={this.state.selectedItem} />;
}
selectionChanged({ selectedItem }) {
this.setState({ selectedItem });
}
}
export default App;
import React from 'react';
export default function ConditionalIcon({ value }) {
if(value) {
return (
<img
src={`../../../../images/icons/${value.IconSrc}`}
className='custom-icon'
/>
);
} else {
return (
<div className='dx-dropdowneditor-icon'></div>
);
}
}
import React from 'react';
export default function ImageIcon() {
return (
<img
src="../../../../images/icons/custom-dropbutton-icon.svg"
className="custom-icon"
/>
);
}
import React from 'react';
import LoadIndicator from 'devextreme-react/load-indicator';
export default function IndicatorIcon({ isLoaded }) {
return (
<span>
<LoadIndicator visible={!isLoaded} />
<span hidden={!isLoaded}>
<img
src='../../../../images/icons/custom-dropbutton-icon.svg'
className='custom-icon'
/>
</span>
</span>
);
}
import React from 'react';
export default function Item({ IconSrc, Name }) {
return (
<div className='custom-item'>
<img src={`../../../../images/icons/${IconSrc}`} />
<div className='product-name'>
{ Name }
</div>
</div>
);
}
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(
<App />,
document.getElementById('app')
);
<!DOCTYPE html>
<html>
<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" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.1.6/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.1.6/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="https://unpkg.com/core-js@2.4.1/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.js');
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
.dx-dropdowneditor-button .dx-button-content {
text-align: center;
}
.dx-theme-material .dx-dropdowneditor-button .dx-button-content .dx-loadindicator {
width: 24px;
height: 24px;
}
.custom-icon {
max-height: 100%;
max-width: 100%;
font-size: 28px;
display: inline-block;
vertical-align: middle;
}
.dx-theme-android5 .custom-item img {
padding: 4px 22px 0 0;
}
.custom-item img {
float: right;
}
.custom-item .product-name {
line-height: 32px;
padding-left: 5px;
}
export const simpleProducts = [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
'SuperLED 50',
'SuperLED 42'
];
export const products = [{
'ID': 1,
'Name': 'HD Video Player',
'Price': 330,
'Current_Inventory': 225,
'Backorder': 0,
'Manufacturing': 10,
'Category': 'Video Players',
'IconSrc': 'video-player.svg'
}, {
'ID': 2,
'Name': 'SuperHD Player',
'Price': 400,
'Current_Inventory': 150,
'Backorder': 0,
'Manufacturing': 25,
'Category': 'Video Players',
'IconSrc': 'video-player.svg'
}, {
'ID': 3,
'Name': 'SuperPlasma 50',
'Price': 2400,
'Current_Inventory': 0,
'Backorder': 0,
'Manufacturing': 0,
'Category': 'Televisions',
'IconSrc': 'tv.svg'
}, {
'ID': 4,
'Name': 'SuperLED 50',
'Price': 1600,
'Current_Inventory': 77,
'Backorder': 0,
'Manufacturing': 55,
'Category': 'Televisions',
'IconSrc': 'tv.svg'
}, {
'ID': 5,
'Name': 'SuperLED 42',
'Price': 1450,
'Current_Inventory': 445,
'Backorder': 0,
'Manufacturing': 0,
'Category': 'Televisions',
'IconSrc': 'tv.svg'
}];
System.config({
transpiler: 'plugin-babel',
meta: {
},
paths: {
'npm:': 'https://unpkg.com/'
},
defaultExtension: 'js',
map: {
'react': 'npm:react@16/umd/react.development.js',
'react-dom': 'npm:react-dom@16/umd/react-dom.development.js',
'prop-types': 'npm:prop-types/prop-types.js',
'devextreme': 'npm:devextreme@20.1',
'devextreme-react': 'npm:devextreme-react@20.1',
'jszip': 'npm:jszip@3.1.3/dist/jszip.min.js',
'quill': 'npm:quill@1.3.7/dist/quill.js',
'devexpress-diagram': 'npm:devexpress-diagram@1.0.9',
'devexpress-gantt': 'npm:devexpress-gantt@1.0.7',
// SystemJS plugins
'plugin-babel': 'npm:systemjs-plugin-babel@0/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0/systemjs-babel-browser.js'
},
packages: {
'devextreme': {
defaultExtension: 'js'
},
'devextreme-react': {
main: 'index.js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
},
babelOptions: {
sourceMaps: false,
stage0: true,
react: true
}
});