Your search did not match any results.
Drop Down Button

Drop Down Button

The DropDownButton is a button that opens a drop-down menu. The button displays a text and an icon.

Menu items can be specified in the items or dataSource options. Use dataSource if data is remote or should be processed. To customize menu items, implement an itemTemplate.

The DropDownButton stores the most recent selected menu item if you set the useSelectMode option to true. In this case, the button uses the selected item’s text and icon.

You can implement a dropDownContentTemplate to replace the drop-down menu with custom content.

To track and handle events, use the onButtonClick, onItemClick, and onSelectionChanged event handlers.

Copy to CodePen
Apply
Reset
$(function(){ $("#one-section").dxDropDownButton({ text: "Download Trial", icon: "save", width: 173, dropDownOptions: { width: 230 }, onItemClick: function(e) { DevExpress.ui.notify("Download " + e.itemData, "success", 600); }, items: downloads }); $("#two-sections").dxDropDownButton({ items: profileSettings, splitButton: true, width: 173, onButtonClick: function(e) { DevExpress.ui.notify("Go to " + e.component.option("text") + "'s profile", "success", 600); }, onItemClick: function(e) { DevExpress.ui.notify(e.itemData.name, "success", 600); }, text: "Sandra Johnson", icon: "../../../../images/gym/coach-woman.png", displayExpr: "name", keyExpr: "id", useSelectMode: false }); $("#template").dxToolbar({ items: [ { location: "before", widget: "dxDropDownButton", options: { displayExpr: "name", keyExpr: "id", selectedItemKey: 1, width: 120, stylingMode: "text", useSelectMode: true, onSelectionChanged: function(e) { $("#text").css("text-align", e.item.name.toLowerCase()); }, items: alignments } }, { location: "before", widget: "dxDropDownButton", options: { items: colors, icon: "square", stylingMode: "text", onInitialized: function(e) { dropDownButton = e.component; }, dropDownContentTemplate: function(data, $container) { var $colorPicker = $("<div>") .addClass("custom-color-picker") .appendTo($container); data.forEach(function(color){ var $button = $("<i>") .addClass("color dx-icon dx-icon-square") .on("dxclick", function() { applyColor($("#text"), color); applyColor(dropDownButton.$element().find(".dx-dropdownbutton-action .dx-icon").first(), color); dropDownButton.close(); }); applyColor($button, color); $colorPicker.append($button); }); } } }, { location: "before", widget: "dxDropDownButton", options: { stylingMode: "text", displayExpr: "text", keyExpr: "size", useSelectMode: true, items: fontSizes, selectedItemKey: 14, onSelectionChanged: function(e) { $("#text").css("font-size", e.item.size + "px"); }, itemTemplate: function(itemData) { return $("<div>") .text(itemData.text) .css("font-size", itemData.size + "px"); } } }, { location: "before", widget: "dxDropDownButton", options: { stylingMode: "text", icon: "indent", displayExpr: "text", keyExpr: "lineHeight", useSelectMode: true, items: lineHeights, selectedItemKey: 1.35, onSelectionChanged: function(e) { $("#text").css("line-height", e.item.lineHeight); } } } ] }); }); var dropDownButton; function applyColor($element, color){ if (color){ $element.removeClass("dx-theme-text-color"); $element.css("color", color); } else { $element.addClass("dx-theme-text-color"); } };
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <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"/> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/19.1.5/css/dx.common.css"/> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/19.1.5/css/dx.light.css"/> <script src="https://cdn3.devexpress.com/jslib/19.1.5/js/dx.all.js"></script> <link rel="stylesheet" type="text/css" href="styles.css"/> <script src="data.js"></script> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div class="dx-fieldset"> <div class="dx-fieldset-header">Single usage</div> <div class="dx-field"> <div class="dx-field-label"> Custom static text </div> <div class="dx-field-value"> <div id="one-section"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label"> Custom main button action </div> <div class="dx-field-value"> <div id="two-sections"></div> </div> </div> </div> <div class="dx-fieldset"> <div class="dx-fieldset-header">Usage in a toolbar</div> <div class="dx-field"> <div id="template"></div> </div> <div class="dx-field"> <p id="text">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> </body> </html>
.demo-container .dx-fieldset:first-child { width: 500px; } .custom-color-picker { width: 82px; padding: 5px; } .dx-button-content img.dx-icon { width: 24px; height: 24px; } .color { cursor: pointer; font-size: 18px; } #text { line-height: 1.35; }
var colors = [null, "#980000", "#ff0000", "#ff9900", "#ffff00", "#00ff00", "#00ffff", "#4a86e8", "#0000ff", "#9900ff", "#ff00ff", "#ff3466"]; var 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" } ]; var downloads = ["Download Trial For Visual Studio", "Download Trial For All Platforms", "Package Managers"]; var 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" } ]; var fontSizes = [ { size: 10, text: "10px" }, { size: 12, text: "12px" }, { size: 14, text: "14px" }, { size: 16, text: "16px" }, { size: 18, text: "18px" } ]; var lineHeights = [ { lineHeight: 1, text: "1" }, { lineHeight: 1.35, text: "1.35" }, { lineHeight: 1.5, text: "1.5" }, { lineHeight: 2, text: "2" } ];