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 Menu features used.
Backend API
import React, { useCallback, useState } from 'react';
import { Menu, type MenuTypes } from 'devextreme-react/menu';
import { SelectBox, type SelectBoxTypes } from 'devextreme-react/select-box';
import { CheckBox, type CheckBoxTypes } from 'devextreme-react/check-box';
import { products } from './data.ts';
import type { Product, ProductItem } from './types.ts';
const orientations: MenuTypes.Orientation[] = ['horizontal', 'vertical'];
const orientationLabel = { 'aria-label': 'Orientation' };
const showSubmenuModeLabel = { 'aria-label': 'Show Submenu Mode' };
interface ShowSubmenuMode {
name: MenuTypes.SubmenuShowMode,
delay: {
show: number,
hide: number
}
}
const showSubmenuModes: ShowSubmenuMode[] = [
{
name: 'onHover',
delay: { show: 0, hide: 500 },
},
{
name: 'onClick',
delay: { show: 0, hide: 300 },
},
];
const isProductItem = (item: Product | ProductItem | undefined): item is ProductItem =>
!!item && !('items' in item);
const App = () => {
const [showFirstSubmenuModes, setShowFirstSubmenuModes] = useState<ShowSubmenuMode>(showSubmenuModes[1]);
const [orientation, setOrientation] = useState<MenuTypes.Orientation>('horizontal');
const [hideSubmenuOnMouseLeave, setHideSubmenuOnMouseLeave] = useState<boolean>(false);
const [currentProduct, setCurrentProduct] = useState<ProductItem | null>(null);
const itemClick = useCallback((e: MenuTypes.ItemClickEvent<Product>): void => {
if (isProductItem(e.itemData)) {
setCurrentProduct(e.itemData);
}
}, []);
const showSubmenuModeChanged = useCallback((e: SelectBoxTypes.ValueChangedEvent): void => {
setShowFirstSubmenuModes(e.value);
}, []);
const orientationChanged = useCallback((e: SelectBoxTypes.ValueChangedEvent): void => {
setOrientation(e.value);
}, []);
const hideSubmenuOnMouseLeaveChanged = useCallback((e: CheckBoxTypes.ValueChangedEvent): void => {
setHideSubmenuOnMouseLeave(e.value);
}, []);
return (
<div className="form">
<div>
<div className="label">Catalog:</div>
<Menu
dataSource={products}
displayExpr="name"
showFirstSubmenuMode={showFirstSubmenuModes}
orientation={orientation}
hideSubmenuOnMouseLeave={hideSubmenuOnMouseLeave}
onItemClick={itemClick}
/>
{currentProduct && (
<div id="product-details">
<img src={currentProduct.icon} alt="Product icon" />
<div className="name">{currentProduct.name}</div>
<div className="price">{`$${currentProduct.price}`}</div>
</div>
)}
</div>
<div className="options">
<div className="caption">Options</div>
<div className="option">
<div>Show First Submenu Mode</div>
<SelectBox
items={showSubmenuModes}
displayExpr="name"
inputAttr={showSubmenuModeLabel}
value={showFirstSubmenuModes}
onValueChanged={showSubmenuModeChanged}
/>
</div>
<div className="option">
<div>Orientation</div>
<SelectBox
items={orientations}
inputAttr={orientationLabel}
value={orientation}
onValueChanged={orientationChanged}
/>
</div>
<div className="option">
<CheckBox
text="Hide Submenu on Mouse Leave"
value={hideSubmenuOnMouseLeave}
onValueChanged={hideSubmenuOnMouseLeaveChanged}
/>
</div>
</div>
</div>
);
};
export default App;
import React, { useCallback, useState } from 'react';
import { Menu } from 'devextreme-react/menu';
import { SelectBox } from 'devextreme-react/select-box';
import { CheckBox } from 'devextreme-react/check-box';
import { products } from './data.js';
const orientations = ['horizontal', 'vertical'];
const orientationLabel = { 'aria-label': 'Orientation' };
const showSubmenuModeLabel = { 'aria-label': 'Show Submenu Mode' };
const showSubmenuModes = [
{
name: 'onHover',
delay: { show: 0, hide: 500 },
},
{
name: 'onClick',
delay: { show: 0, hide: 300 },
},
];
const isProductItem = (item) => !!item && !('items' in item);
const App = () => {
const [showFirstSubmenuModes, setShowFirstSubmenuModes] = useState(showSubmenuModes[1]);
const [orientation, setOrientation] = useState('horizontal');
const [hideSubmenuOnMouseLeave, setHideSubmenuOnMouseLeave] = useState(false);
const [currentProduct, setCurrentProduct] = useState(null);
const itemClick = useCallback((e) => {
if (isProductItem(e.itemData)) {
setCurrentProduct(e.itemData);
}
}, []);
const showSubmenuModeChanged = useCallback((e) => {
setShowFirstSubmenuModes(e.value);
}, []);
const orientationChanged = useCallback((e) => {
setOrientation(e.value);
}, []);
const hideSubmenuOnMouseLeaveChanged = useCallback((e) => {
setHideSubmenuOnMouseLeave(e.value);
}, []);
return (
<div className="form">
<div>
<div className="label">Catalog:</div>
<Menu
dataSource={products}
displayExpr="name"
showFirstSubmenuMode={showFirstSubmenuModes}
orientation={orientation}
hideSubmenuOnMouseLeave={hideSubmenuOnMouseLeave}
onItemClick={itemClick}
/>
{currentProduct && (
<div id="product-details">
<img
src={currentProduct.icon}
alt="Product icon"
/>
<div className="name">{currentProduct.name}</div>
<div className="price">{`$${currentProduct.price}`}</div>
</div>
)}
</div>
<div className="options">
<div className="caption">Options</div>
<div className="option">
<div>Show First Submenu Mode</div>
<SelectBox
items={showSubmenuModes}
displayExpr="name"
inputAttr={showSubmenuModeLabel}
value={showFirstSubmenuModes}
onValueChanged={showSubmenuModeChanged}
/>
</div>
<div className="option">
<div>Orientation</div>
<SelectBox
items={orientations}
inputAttr={orientationLabel}
value={orientation}
onValueChanged={orientationChanged}
/>
</div>
<div className="option">
<CheckBox
text="Hide Submenu on Mouse Leave"
value={hideSubmenuOnMouseLeave}
onValueChanged={hideSubmenuOnMouseLeaveChanged}
/>
</div>
</div>
</div>
);
};
export default App;
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
import type { Product } from './types';
export const products: Product[] = [{
id: '1',
name: 'Video Players',
items: [{
id: '1_1',
name: 'HD Video Player',
price: 220,
icon: '../../../../images/products/1.png',
}, {
id: '1_2',
name: 'SuperHD Video Player',
icon: '../../../../images/products/2.png',
price: 270,
}],
}, {
id: '2',
name: 'Televisions',
items: [{
id: '2_1',
name: 'SuperLCD 42',
icon: '../../../../images/products/7.png',
price: 1200,
}, {
id: '2_2',
name: 'SuperLED 42',
icon: '../../../../images/products/5.png',
price: 1450,
}, {
id: '2_3',
name: 'SuperLED 50',
icon: '../../../../images/products/4.png',
price: 1600,
}, {
id: '2_4',
name: 'SuperLCD 55 (Not available)',
icon: '../../../../images/products/6.png',
price: 1350,
disabled: true,
}, {
id: '2_5',
name: 'SuperLCD 70',
icon: '../../../../images/products/9.png',
price: 4000,
}],
}, {
id: '3',
name: 'Monitors',
items: [{
id: '3_1',
name: '19"',
items: [{
id: '3_1_1',
name: 'DesktopLCD 19',
icon: '../../../../images/products/10.png',
price: 160,
}],
}, {
id: '3_2',
name: '21"',
items: [{
id: '3_2_1',
name: 'DesktopLCD 21',
icon: '../../../../images/products/12.png',
price: 170,
}, {
id: '3_2_2',
name: 'DesktopLED 21',
icon: '../../../../images/products/13.png',
price: 175,
}],
}],
}, {
id: '4',
name: 'Projectors',
items: [{
id: '4_1',
name: 'Projector Plus',
icon: '../../../../images/products/14.png',
price: 550,
}, {
id: '4_2',
name: 'Projector PlusHD',
icon: '../../../../images/products/15.png',
price: 750,
}],
}];
export interface ProductItem {
id: string,
name: string,
price: number,
icon: string,
disabled?: boolean,
}
export interface Product {
id: string,
name: string,
items: (Product | ProductItem)[],
}
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
export const products = [
{
id: '1',
name: 'Video Players',
items: [
{
id: '1_1',
name: 'HD Video Player',
price: 220,
icon: '../../../../images/products/1.png',
},
{
id: '1_2',
name: 'SuperHD Video Player',
icon: '../../../../images/products/2.png',
price: 270,
},
],
},
{
id: '2',
name: 'Televisions',
items: [
{
id: '2_1',
name: 'SuperLCD 42',
icon: '../../../../images/products/7.png',
price: 1200,
},
{
id: '2_2',
name: 'SuperLED 42',
icon: '../../../../images/products/5.png',
price: 1450,
},
{
id: '2_3',
name: 'SuperLED 50',
icon: '../../../../images/products/4.png',
price: 1600,
},
{
id: '2_4',
name: 'SuperLCD 55 (Not available)',
icon: '../../../../images/products/6.png',
price: 1350,
disabled: true,
},
{
id: '2_5',
name: 'SuperLCD 70',
icon: '../../../../images/products/9.png',
price: 4000,
},
],
},
{
id: '3',
name: 'Monitors',
items: [
{
id: '3_1',
name: '19"',
items: [
{
id: '3_1_1',
name: 'DesktopLCD 19',
icon: '../../../../images/products/10.png',
price: 160,
},
],
},
{
id: '3_2',
name: '21"',
items: [
{
id: '3_2_1',
name: 'DesktopLCD 21',
icon: '../../../../images/products/12.png',
price: 170,
},
{
id: '3_2_2',
name: 'DesktopLED 21',
icon: '../../../../images/products/13.png',
price: 175,
},
],
},
],
},
{
id: '4',
name: 'Projectors',
items: [
{
id: '4_1',
name: 'Projector Plus',
icon: '../../../../images/products/14.png',
price: 550,
},
{
id: '4_2',
name: 'Projector PlusHD',
icon: '../../../../images/products/15.png',
price: 750,
},
],
},
];
<!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/26.1.5/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="./bundle.css" />
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
<script src="bundles/vendor/react.vendor.js"></script>
<script src="./bundle.js"></script>
</body>
</html>
.form {
margin-left: 3px;
}
.form > div:first-child {
margin-right: 320px;
}
.label {
font-size: 22px;
padding-bottom: 24px;
}
#product-details {
width: 400px;
height: 400px;
margin: 20px auto 0;
}
#product-details > img {
height: 300px;
width: 400px;
}
#product-details > .name {
text-align: center;
font-size: 20px;
}
#product-details > .price {
text-align: center;
font-size: 24px;
}
.dark #product-details > div {
color: #f0f0f0;
}
.options {
padding: 20px;
position: absolute;
bottom: 0;
right: 0;
width: 260px;
top: 0;
background-color: rgba(191, 191, 191, 0.15);
}
.caption {
font-size: 18px;
font-weight: 500;
}
.option {
margin-top: 10px;
}
.hidden {
visibility: hidden;
}
Configure the Menu
Use the orientation property to specify whether the Menu has horizontal or vertical orientation. Use the animation property to specify the type, delay, duration, and other options of show and hide menu actions.
Configure the Submenus
Clicking or a hovering a Menu item opens a drop-down menu that can contain several submenus. To specify the drop-down menu mode ("onClick" or "onHover"), use the showSubmenuMode property. If you need only to specify the first level of drop-down menus, use the showFirstSubmenuMode property.
If you want to hide the submenu when the mouse pointer leaves it, set the hideSubmenuOnMouseLeave property to true.
Customize Item Appearance
You can define specific fields in the item data objects to change the appearance of an item. For example, use the icon property to supply items with icons. Define an itemTemplate to customize item appearance.