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 DropDownButton features used.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you for the feedback!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Backend API
<template>
<div>
<div class="dx-fieldset">
<div class="dx-fieldset-header">Standalone button</div>
<div class="dx-field">
<div class="dx-field-label">
Text and icon
</div>
<div class="dx-field-value">
<DxDropDownButton
:items="data.downloads"
:drop-down-options="{ width: 230 }"
text="Download Trial"
icon="save"
@item-click="onItemClick"
/>
</div>
</div>
<div class="dx-field">
<div class="dx-field-label">Custom template and actions</div>
<div class="dx-field-value">
<DxDropDownButton
id="custom-template"
:split-button="true"
:use-select-mode="false"
:items="data.profileSettings"
display-expr="name"
key-expr="id"
@button-click="onButtonClick"
@item-click="onItemClick"
template="dropDownButtonTemplate"
>
<template #dropDownButtonTemplate="{ data }">
<div class="button-img-container">
<div class="button-img-indicator"/>
<img
class="button-img"
:src="employeeImageUrl"
alt="employee"
>
</div>
<div class="text-container">
<div class="button-title">Olivia Peyton</div>
<div class="button-row">IT Manager</div>
</div>
</template>
</DxDropDownButton>
</div>
</div>
</div>
<div class="dx-fieldset">
<div class="dx-fieldset-header">Embedded in a Toolbar</div>
<div class="dx-field">
<DxToolbar :items="toolbarItems">
<template #fontItem="{ data }">
<div :style="{ fontSize: data.size + 'px'}">
{{ data.text }}
</div>
</template>
<template #colorpicker="{ data }">
<div class="custom-color-picker">
<i
v-for="(itemColor, i) in data"
:key="i"
class="dx-icon dx-icon-square"
:style="{ color: itemColor }"
@click="onColorClick(itemColor)"
/>
</div>
</template>
</DxToolbar>
</div>
<div class="dx-field">
<p
id="text"
:style="{
textAlign: alignment,
fontSize: fontSize,
color: color,
lineHeight: lineHeight
}"
>Lorem ipsum dolor sit amet, consectetur adipiscing elit,
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in
reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
</div>
</div>
</div>
</template>
<script setup lang="ts">
import { ref } from 'vue';
import DxDropDownButton from 'devextreme-vue/drop-down-button';
import DxToolbar from 'devextreme-vue/toolbar';
import notify from 'devextreme/ui/notify';
import service from './data.ts';
import 'whatwg-fetch';
const alignment = ref('left');
const color = ref(null);
const fontSize = ref('14px');
const lineHeight = ref(1.35);
let colorPicker;
const data = service.getData();
const employeeImageUrl = data.getEmployeeImageUrl();
const toolbarItems = [
{
location: 'before',
widget: 'dxDropDownButton',
options: {
displayExpr: 'name',
keyExpr: 'id',
selectedItemKey: 3,
width: 125,
stylingMode: 'text',
useSelectMode: true,
onSelectionChanged: (e) => {
alignment.value = e.item.name.toLowerCase();
},
items: data.alignments,
},
},
{
location: 'before',
widget: 'dxDropDownButton',
options: {
items: data.colors,
onInitialized: ({ component }) => {
colorPicker = component;
},
icon: 'square',
stylingMode: 'text',
dropDownOptions: { width: 'auto' },
dropDownContentTemplate: 'colorpicker',
},
},
{
location: 'before',
widget: 'dxDropDownButton',
options: {
stylingMode: 'text',
displayExpr: 'text',
keyExpr: 'size',
useSelectMode: true,
items: data.fontSizes,
selectedItemKey: 14,
onSelectionChanged: (e) => {
fontSize.value = `${e.item.size}px`;
},
itemTemplate: 'fontItem',
},
},
{
location: 'before',
widget: 'dxDropDownButton',
options: {
stylingMode: 'text',
icon: 'indent',
displayExpr: 'text',
keyExpr: 'lineHeight',
useSelectMode: true,
items: data.lineHeights,
selectedItemKey: 1.35,
onSelectionChanged: (e) => {
lineHeight.value = e.item.lineHeight;
},
},
},
];
function onButtonClick(e) {
notify(`Go to ${e.element.querySelector('.button-title').textContent}'s profile`, 'success', 600);
}
function onItemClick(e) {
notify(e.itemData.name || e.itemData, 'success', 600);
}
function onColorClick(clickedColor) {
color.value = clickedColor;
colorPicker.element().getElementsByClassName('dx-icon-square')[0].style.color = clickedColor;
colorPicker.close();
}
</script>
<style scoped>
.demo-container .dx-fieldset:first-child {
width: 500px;
}
.dx-popup-content > .dx-template-wrapper.custom-color-picker {
width: 82px;
padding: 5px;
}
.color {
cursor: pointer;
font-size: 18px;
}
.text-container {
padding-inline-start: 12px;
padding-inline-end: 4px;
display: flex;
align-items: flex-start;
flex-direction: column;
}
.button-img-container {
position: relative;
height: 32px;
}
.button-img {
width: 32px;
height: 32px;
position: relative;
border-width: 1px;
border-style: solid;
border-color: var(--dx-color-border);
border-radius: 50%;
}
.button-img-indicator {
position: absolute;
background-color: var(--dx-color-danger);
top: -1px;
inset-inline-end: -1px;
width: 10px;
height: 10px;
border-radius: 50%;
border-width: 2px;
border-style: solid;
border-color: var(--dx-color-main-bg);
z-index: 1;
}
.button-title {
line-height: 20px;
}
.button-row {
font-size: 12px;
line-height: 14px;
opacity: 0.6;
}
#custom-template .dx-button {
height: 46px;
}
#custom-template .dx-button.dx-dropdownbutton-action .dx-button-content {
padding-inline-start: 12px;
padding-inline-end: 12px;
}
</style>
window.exports = window.exports || {};
window.config = {
transpiler: 'plugin-babel',
meta: {
'*.vue': {
loader: 'vue-loader',
},
'*.ts': {
loader: 'demo-ts-loader',
},
'*.svg': {
loader: 'svg-loader',
},
'devextreme/time_zone_utils.js': {
'esModule': true,
},
'devextreme/localization.js': {
'esModule': true,
},
'devextreme/viz/palette.js': {
'esModule': true,
},
},
paths: {
'root:': '../../../../',
'npm:': 'https://unpkg.com/',
},
map: {
'vue': 'npm:vue@3.2.47/dist/vue.esm-browser.js',
'vue-loader': 'npm:dx-systemjs-vue-browser@1.1.1/index.js',
'demo-ts-loader': 'root:utils/demo-ts-loader.js',
'svg-loader': 'root:utils/svg-loader.js',
'whatwg-fetch': 'npm:whatwg-fetch@2.0.4/fetch.js',
'mitt': 'npm:mitt/dist/mitt.umd.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.6/cjs',
'devextreme-vue': 'npm:devextreme-vue@24.1.6/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.11/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',
'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-vue': {
main: 'index.js',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'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,
},
};
System.config(window.config);
const colors = [null, '#980000', '#ff0000', '#ff9900', '#ffff00', '#00ff00', '#00ffff', '#4a86e8', '#0000ff', '#9900ff', '#ff00ff', '#ff3466'];
const profileSettings = [
{ id: 1, name: 'Profile', icon: 'user' },
{
id: 4, name: 'Messages', icon: 'email', badge: '5',
},
{ id: 2, name: 'Friends', icon: 'group' },
{ id: 3, name: 'Exit', icon: 'runner' },
];
const downloads = ['Download Trial For Visual Studio', 'Download Trial For All Platforms', 'Package Managers'];
const alignments = [
{ id: 1, name: 'Left', icon: 'alignleft' },
{ id: 4, name: 'Right', icon: 'alignright' },
{ id: 2, name: 'Center', icon: 'aligncenter' },
{ id: 3, name: 'Justify', icon: 'alignjustify' },
];
const fontSizes = [
{ size: 10, text: '10px' },
{ size: 12, text: '12px' },
{ size: 14, text: '14px' },
{ size: 16, text: '16px' },
{ size: 18, text: '18px' },
];
const lineHeights = [
{ lineHeight: 1, text: '1' },
{ lineHeight: 1.35, text: '1.35' },
{ lineHeight: 1.5, text: '1.5' },
{ lineHeight: 2, text: '2' },
];
function getEmployeeImageUrl(): string {
return '../../../../images/employees/51.png';
}
export default {
getData() {
return {
colors,
profileSettings,
downloads,
alignments,
fontSizes,
lineHeights,
getEmployeeImageUrl,
};
},
};
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
<!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.6/css/dx.light.css" />
<script src="https://unpkg.com/typescript@4.9.5/lib/typescript.js"></script>
<script type="module">
import * as vueCompilerSFC from "https://unpkg.com/@vue/compiler-sfc@3.4.16/dist/compiler-sfc.esm-browser.js";
window.vueCompilerSFC = vueCompilerSFC;
</script>
<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.ts");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"> </div>
</div>
</body>
</html>
Menu items can be specified in the items or dataSource properties. Use dataSource if data is remote or should be processed.
DropDownButton stores the most recent selected menu item if you set the useSelectMode property to true. In this case, the button uses the selected item's text and icon.
To customize DropDownButton, specify the the following options:
-
itemTemplate
Customizes menu items. -
template
Customizes a base button. -
dropDownContentTemplate
Replaces the drop-down menu with custom content.
To track and handle events, use the onButtonClick, onItemClick, and onSelectionChanged event handlers.