Help us shape the 2021 DevExtreme Roadmap.
Take our 5 minute survey.
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.
<template>
<div>
<div class="dx-fieldset">
<div class="dx-field">
<div class="dx-field-label">Image as the icon</div>
<div class="dx-field-value">
<DxSelectBox
:data-source="simpleProducts"
drop-down-button-template="imageIcon"
>
<template #imageIcon="{}">
<img
src="../../../../images/icons/custom-dropbutton-icon.svg"
class="custom-icon"
>
</template>
</DxSelectBox>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Load indicator as the icon</div>
<div class="dx-field-value">
<DxSelectBox
:data-source="deferredProducts"
drop-down-button-template="loadIcon"
>
<template #loadIcon="{}">
<div>
<DxLoadIndicator :visible="!isLoaded"/>
<span :hidden="!isLoaded">
<img
src="../../../../images/icons/custom-dropbutton-icon.svg"
class="custom-icon"
>
</span>
</div>
</template>
</DxSelectBox>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Value-dependent icon</div>
<div class="dx-field-value">
<DxSelectBox
:data-source="products"
v-model:selected-item="selectedItem"
:value="1"
:show-clear-button="true"
display-expr="Name"
value-expr="ID"
drop-down-button-template="valueIcon"
item-template="customItem"
>
<template #valueIcon="{}">
<div>
<img
v-if="selectedItem"
:src="'../../../../images/icons/' + selectedItem.IconSrc"
class="custom-icon"
>
<div
v-if="!selectedItem"
class="dx-dropdowneditor-icon"
/>
</div>
</template>
<template #customItem="{ data: itemData }">
<div class="custom-item">
<img :src="'../../../../images/icons/' + itemData.IconSrc">
<div class="product-name">
{{ itemData.Name }}
</div>
</div>
</template>
</DxSelectBox>
</div>
</div>
</div>
</div>
</template>
<script>
import { DxSelectBox } from 'devextreme-vue/select-box';
import { DxLoadIndicator } from 'devextreme-vue/load-indicator';
import { products, simpleProducts } from './data.js';
export default {
components: {
DxSelectBox,
DxLoadIndicator
},
data() {
return {
products,
simpleProducts,
isLoaded: true,
deferredProducts: {
loadMode: 'raw',
load: () => {
this.isLoaded = false;
var promise = new Promise((resolve) => {
setTimeout(() => {
resolve(simpleProducts);
this.isLoaded = true;
}, 3000);
});
return promise;
}
},
selectedItem: products[0]
};
}
};
</script>
<style scoped>
.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;
}
</style>
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#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.2.5/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.5/css/dx.light.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>
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: {
'*.vue': {
loader: 'vue-loader'
},
'devextreme/localization.js': {
"esModule": true
},
},
paths: {
'npm:': 'https://unpkg.com/'
},
map: {
'vue': 'npm:vue@3.0.0/dist/vue.esm-browser.js',
'vue-loader': 'npm:dx-systemjs-vue-browser@1.0.15/index.js',
'mitt': 'npm:mitt/dist/mitt.umd.js',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.25.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@20.2.5',
'devextreme-vue': 'npm:devextreme-vue@20.2.5',
'jszip': 'npm:jszip@3.5.0/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@0.9.8/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.0.11/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@2.0.18/dist/dx-gantt.js',
'preact': 'npm:preact@10.5.11/dist/preact.js',
'preact/hooks': 'npm:preact@10.5.11/hooks/dist/hooks.js',
'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'
},
packages: {
'devextreme-vue': {
main: 'index.js'
},
'devextreme': {
defaultExtension: 'js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js'
}
},
babelOptions: {
sourceMaps: false,
stage0: true
}
});