DevExtreme v23.2 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Menu

Populate Menu with Data and Configure the Access to It

You can display Menu items from the items array or a dataSource. This demo contains an example of a data structure. If you use a dataSource, specify the displayExpr property.

To access the clicked item, use the onItemClick event handler function.

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.

Backend API
import React, { useCallback, useState } from 'react'; import Menu, { MenuTypes } from 'devextreme-react/menu'; import SelectBox, { SelectBoxTypes } from 'devextreme-react/select-box'; import CheckBox, { CheckBoxTypes } from 'devextreme-react/check-box'; import service, { ProductItemType } from './data.ts'; const orientations = ['horizontal', 'vertical']; const orientationLabel = { 'aria-label': 'Orientation' }; const showSubmenuModeLabel = { 'aria-label': 'Show Submenu Mode' }; const products = service.getProducts(); interface showSubmenuModesType { name: MenuTypes.SubmenuShowMode, delay: { show: number, hide: number } } const showSubmenuModes: showSubmenuModesType[] = [ { name: 'onHover', delay: { show: 0, hide: 500 }, }, { name: 'onClick', delay: { show: 0, hide: 300 }, }, ]; const App = () => { const [showFirstSubmenuModes, setShowFirstSubmenuModes] = useState(showSubmenuModes[1]); const [orientation, setOrientation] = useState<MenuTypes.Orientation>('horizontal'); const [hideSubmenuOnMouseLeave, setHideSubmenuOnMouseLeave] = useState(false); const [currentProduct, setCurrentProduct] = useState(null); const itemClick = useCallback((e: MenuTypes.ItemClickEvent & { itemData: ProductItemType }) => { if (e.itemData.price) { setCurrentProduct(e.itemData); } }, [setCurrentProduct]); const showSubmenuModeChanged = useCallback((e: SelectBoxTypes.ValueChangedEvent) => { setShowFirstSubmenuModes(e.value); }, [setShowFirstSubmenuModes]); const orientationChanged = useCallback((e: SelectBoxTypes.ValueChangedEvent) => { setOrientation(e.value); }, [setOrientation]); const hideSubmenuOnMouseLeaveChanged = useCallback((e: CheckBoxTypes.ValueChangedEvent) => { setHideSubmenuOnMouseLeave(e.value); }, [setHideSubmenuOnMouseLeave]); 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} /> <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 service from './data.js'; const orientations = ['horizontal', 'vertical']; const orientationLabel = { 'aria-label': 'Orientation' }; const showSubmenuModeLabel = { 'aria-label': 'Show Submenu Mode' }; const products = service.getProducts(); const showSubmenuModes = [ { name: 'onHover', delay: { show: 0, hide: 500 }, }, { name: 'onClick', delay: { show: 0, hide: 300 }, }, ]; 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 (e.itemData.price) { setCurrentProduct(e.itemData); } }, [setCurrentProduct], ); const showSubmenuModeChanged = useCallback( (e) => { setShowFirstSubmenuModes(e.value); }, [setShowFirstSubmenuModes], ); const orientationChanged = useCallback( (e) => { setOrientation(e.value); }, [setOrientation], ); const hideSubmenuOnMouseLeaveChanged = useCallback( (e) => { setHideSubmenuOnMouseLeave(e.value); }, [setHideSubmenuOnMouseLeave], ); 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} /> <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'), );
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, }], }]; export interface ProductItemType { id: string, name: string, price: number, icon: string, } export interface ProductType { id: string, name: string, items: (ProductItemType | ProductType)[], } export default { getProducts(): ProductType[] { return products; }, };
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.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@23.2.4/cjs', 'devextreme-react': 'npm:devextreme-react@23.2.4/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.51/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', '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', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins '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.4/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: '', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.12/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
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, }, ], }, ]; export default { getProducts() { return products; }, };
<!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/23.2.4/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <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.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </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; }