DevExtreme v24.1 is now available.

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

Your search did not match any results.

React Button - Icons

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

Backend API
import React from 'react'; import { Button } from 'devextreme-react/button'; import notify from 'devextreme/ui/notify'; const weatherClick = () => { notify('The Weather button was clicked'); }; const doneClick = () => { notify('The Done button was clicked'); }; const sendClick = () => { notify('The Send button was clicked'); }; const plusClick = () => { notify('The button was clicked'); }; const backClick = () => { notify('The button was clicked'); }; export default function App() { return ( <div> <div className="dx-fieldset"> <div className="fields-container"> <div className="dx-field"> <div className="dx-field-label">Built-in icon</div> <div className="dx-field-value"> <Button icon="check" type="success" text="Done" onClick={doneClick} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Image icon</div> <div className="dx-field-value"> <Button icon="../../../../images/icons/weather.png" text="Weather" onClick={weatherClick} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">External icon</div> <div className="dx-field-value"> <Button className="send" icon="fa fa-envelope-o" text="Send" onClick={sendClick} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Icon only</div> <div className="dx-field-value"> <Button icon="plus" onClick={plusClick} /> <Button icon="back" id="icon-back" onClick={backClick} /> </div> </div> </div> </div> <div className="dx-fieldset"> <div className="dx-fieldset-header">DISABLED</div> <div className="fields-container"> <div className="dx-field"> <div className="dx-field-value"> <Button icon="check" type="success" text="Done" disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-value"> <Button icon="../../../../images/icons/weather.png" text="Weather" disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-value"> <Button className="send" icon="fa fa-envelope-o" text="Send" disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-value"> <Button icon="plus" disabled={true} /> <Button icon="back" id="icon-disabled-back" disabled={true} /> </div> </div> </div> </div> </div> ); }
import React from 'react'; import { Button } from 'devextreme-react/button'; import notify from 'devextreme/ui/notify'; const weatherClick = () => { notify('The Weather button was clicked'); }; const doneClick = () => { notify('The Done button was clicked'); }; const sendClick = () => { notify('The Send button was clicked'); }; const plusClick = () => { notify('The button was clicked'); }; const backClick = () => { notify('The button was clicked'); }; export default function App() { return ( <div> <div className="dx-fieldset"> <div className="fields-container"> <div className="dx-field"> <div className="dx-field-label">Built-in icon</div> <div className="dx-field-value"> <Button icon="check" type="success" text="Done" onClick={doneClick} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Image icon</div> <div className="dx-field-value"> <Button icon="../../../../images/icons/weather.png" text="Weather" onClick={weatherClick} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">External icon</div> <div className="dx-field-value"> <Button className="send" icon="fa fa-envelope-o" text="Send" onClick={sendClick} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Icon only</div> <div className="dx-field-value"> <Button icon="plus" onClick={plusClick} /> <Button icon="back" id="icon-back" onClick={backClick} /> </div> </div> </div> </div> <div className="dx-fieldset"> <div className="dx-fieldset-header">DISABLED</div> <div className="fields-container"> <div className="dx-field"> <div className="dx-field-value"> <Button icon="check" type="success" text="Done" disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-value"> <Button icon="../../../../images/icons/weather.png" text="Weather" disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-value"> <Button className="send" icon="fa fa-envelope-o" text="Send" disabled={true} /> </div> </div> <div className="dx-field"> <div className="dx-field-value"> <Button icon="plus" disabled={true} /> <Button icon="back" id="icon-disabled-back" disabled={true} /> </div> </div> </div> </div> </div> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
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@24.1.7/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.7/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.13/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', '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.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, '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, 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'));
<!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.7/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.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>
#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.