DevExtreme v24.1 is now available.

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

Your search did not match any results.

JavaScript/jQuery - Button Icons

To add an icon to a JavaScript Button, set the icon property. This demo shows how you can use this property.

Backend API
$(() => { $('#icon-done').dxButton({ icon: 'check', type: 'success', text: 'Done', onClick() { DevExpress.ui.notify('The Done button was clicked'); }, }); $('#icon-weather').dxButton({ icon: '../../../../images/icons/weather.png', text: 'Weather', onClick() { DevExpress.ui.notify('The Weather button was clicked'); }, }); $('#icon-send').dxButton({ icon: 'fa fa-envelope-o', text: 'Send', onClick() { DevExpress.ui.notify('The Send button was clicked'); }, }); $('#icon-plus').dxButton({ icon: 'plus', onClick() { DevExpress.ui.notify('The button was clicked'); }, }); $('#icon-back').dxButton({ icon: 'back', onClick() { DevExpress.ui.notify('The button was clicked'); }, }); $('#icon-disabled-done').dxButton({ icon: 'check', type: 'success', text: 'Done', disabled: true, }); $('#icon-disabled-weather').dxButton({ icon: '../../../../images/icons/weather.png', text: 'Weather', disabled: true, }); $('#icon-disabled-send').dxButton({ icon: 'fa fa-envelope-o', text: 'Send', disabled: true, }); $('#icon-disabled-plus').dxButton({ icon: 'plus', disabled: true, }); $('#icon-disabled-back').dxButton({ icon: 'back', disabled: true, }); });
<!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=5.0" /> <script src=""></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="" /> <link rel="stylesheet" type="text/css" href="" /> <script src="js/dx.all.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div class="dx-fieldset"> <div class="fields-container"> <div class="dx-field"> <div class="dx-field-label">Built-in icon</div> <div class="dx-field-value"> <div id="icon-done"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Image icon</div> <div class="dx-field-value"> <div id="icon-weather"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">External icon</div> <div class="dx-field-value"> <div id="icon-send" class="send"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Icon only</div> <div class="dx-field-value"> <div id="icon-plus"></div> <div id="icon-back"></div> </div> </div> </div> </div> <div class="dx-fieldset"> <div class="dx-fieldset-header">DISABLED</div> <div class="fields-container"> <div class="dx-field"> <div class="dx-field-value"> <div id="icon-disabled-done"></div> </div> </div> <div class="dx-field"> <div class="dx-field-value"> <div id="icon-disabled-weather"></div> </div> </div> <div class="dx-field"> <div class="dx-field-value"> <div id="icon-disabled-send" class="send"></div> </div> </div> <div class="dx-field"> <div class="dx-field-value"> <div id="icon-disabled-plus"></div> <div id="icon-disabled-back"></div> </div> </div> </div> </div> </div> </body> </html>
#icon-back, #icon-disabled-back { margin-left: 4px; } .dx-viewport .dx-fieldset { width: 520px; margin: 30px auto; } .dx-viewport .dx-fieldset:first-child { margin-top: 120px; } .dx-viewport .dx-fieldset-header { font-size: 16px; } .dx-viewport .dx-field { display: inline-block; margin-right: 20px; } .dx-viewport .dx-field-value:not(.dx-widget) > .dx-button { float: none; } .dx-viewport .dx-field-value:not(.dx-switch):not(.dx-checkbox):not(.dx-button), .dx-viewport .dx-field-label { float: none; width: 100%; } .dx-viewport .dx-field-label { padding-left: 0; } .send .dx-button-content .dx-icon { font-size: 18px; } .fields-container { display: flex; align-items: baseline; } .dx-field-value { display: flex; }
  • Built-in icons
    DevExtreme ships with its own icon library. Pick any icon and assign its name to the icon property.

  • Image file
    Set the icon value to the image file path or URI.

  • 3rd-party icon fonts
    You can import a 3rd-party font library (this example uses Font Awesome). In such cases, set the icon property to a name that identifies the required glyph. Look up names in the imported library's documentation.

  • Buttons with icons and no caption text
    Define the icon, but do not define the text property. You can use the hint property to annotate the button.

Refer to the Icons help topic for additional information.