DevExtreme v25.1 is now available.

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

Your search did not match any results.

React Stepper - Step Template

Stepper allows you to customize steps using the DevExtreme template engine. You can set custom markup for indicators including custom step shapes.

This demo uses the itemRender property to customize all steps in a Stepper. For individual step customization, you will need to specify one of the following properties: items[].render or component properties.

Backend API
import React from 'react'; import Stepper from 'devextreme-react/stepper'; import { steps } from './data.ts'; import CustomStepShape from './CustomStepShape.tsx'; import LabelOnly from './LabelOnly.tsx'; import IconOnly from './IconOnly.tsx'; export default function App() { return ( <> <div id="label-customStepShape" className="stepper-label">Custom Step Shape</div> <Stepper id="customStepShape" elementAttr={{ 'aria-labelledby': 'label-customStepShape' }} dataSource={steps} defaultSelectedIndex={2} linear={false} itemRender={CustomStepShape} /> <div id="label-labelOnly" className="stepper-label">Label Only</div> <Stepper id="labelOnly" elementAttr={{ 'aria-labelledby': 'label-labelOnly' }} dataSource={steps} defaultSelectedIndex={2} linear={false} itemRender={LabelOnly} /> <div id="label-iconOnly" className="stepper-label">Icon Only</div> <Stepper id="iconOnly" elementAttr={{ 'aria-labelledby': 'label-iconOnly' }} dataSource={steps} defaultSelectedIndex={2} linear={false} itemRender={IconOnly} /> </> ); }
import React from 'react'; import Stepper from 'devextreme-react/stepper'; import { steps } from './data.js'; import CustomStepShape from './CustomStepShape.js'; import LabelOnly from './LabelOnly.js'; import IconOnly from './IconOnly.js'; export default function App() { return ( <React.Fragment> <div id="label-customStepShape" className="stepper-label" > Custom Step Shape </div> <Stepper id="customStepShape" elementAttr={{ 'aria-labelledby': 'label-customStepShape' }} dataSource={steps} defaultSelectedIndex={2} linear={false} itemRender={CustomStepShape} /> <div id="label-labelOnly" className="stepper-label" > Label Only </div> <Stepper id="labelOnly" elementAttr={{ 'aria-labelledby': 'label-labelOnly' }} dataSource={steps} defaultSelectedIndex={2} linear={false} itemRender={LabelOnly} /> <div id="label-iconOnly" className="stepper-label" > Icon Only </div> <Stepper id="iconOnly" elementAttr={{ 'aria-labelledby': 'label-iconOnly' }} dataSource={steps} defaultSelectedIndex={2} linear={false} itemRender={IconOnly} /> </React.Fragment> ); }
import React from 'react'; import { type StepperTypes } from 'devextreme-react/stepper' export default function CustomStepShape(data: StepperTypes.Item) { return ( <> <div className="dx-step-indicator"> <i className={`dx-icon dx-icon-${data.icon}`}></i> </div> <div className="dx-step-caption"> <div className="dx-step-label">{data.label}</div> {data.optional && <div className="dx-step-optional-mark">(Optional)</div>} </div> </> ); }
import React from 'react'; export default function IconOnly(data) { return ( <i className={`dx-icon dx-icon-${data.icon}`}></i> ); }
import React from 'react'; export default function LabelOnly(data) { return ( <div className="dx-step-caption"> <div className="dx-step-label">{data.label}</div> </div> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import themes from 'devextreme/ui/themes'; import App from './App.tsx'; themes.initialized(() => { ReactDOM.render( <App />, document.getElementById('app'), ); });
export const steps = [{ text: 'A', label: 'Cart', icon: 'cart', }, { text: 'B', label: 'Shipping Info', icon: 'clipboardtasklist', }, { text: 'C', label: 'Promo Code', icon: 'gift', optional: true, }, { text: 'D', label: 'Checkout', icon: 'packagebox', }, { text: 'E', label: 'Ordered', icon: 'checkmarkcircle', }];
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, }, 'openai': { 'esModule': true, }, }, paths: { 'npm:': 'https://cdn.jsdelivr.net/npm/', 'bundles:': '../../../../bundles/', 'externals:': '../../../../bundles/externals/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.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/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@3.4.4/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign', 'devextreme': 'npm:devextreme@25.1.3/cjs', 'devextreme-react': 'npm:devextreme-react@25.1.3/cjs', 'devextreme-quill': 'npm:devextreme-quill@1.7.3/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.19/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.62/dist/dx-gantt.js', 'inferno': 'npm:inferno@8.2.3/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@8.2.3/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate/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', '@preact/signals-core': 'npm:@preact/signals-core@1.8.0/dist/signals-core.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-react/common': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/common/core/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', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; export default function CustomStepShape(data) { return ( <React.Fragment> <div className="dx-step-indicator"> <i className={`dx-icon dx-icon-${data.icon}`}></i> </div> <div className="dx-step-caption"> <div className="dx-step-label">{data.label}</div> {data.optional && <div className="dx-step-optional-mark">(Optional)</div>} </div> </React.Fragment> ); }
import React from 'react'; export default function IconOnly(data) { return <i className={`dx-icon dx-icon-${data.icon}`}></i>; }
import React from 'react'; export default function LabelOnly(data) { return ( <div className="dx-step-caption"> <div className="dx-step-label">{data.label}</div> </div> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import themes from 'devextreme/ui/themes'; import App from './App.js'; themes.initialized(() => { ReactDOM.render(<App />, document.getElementById('app')); });
export const steps = [ { text: 'A', label: 'Cart', icon: 'cart', }, { text: 'B', label: 'Shipping Info', icon: 'clipboardtasklist', }, { text: 'C', label: 'Promo Code', icon: 'gift', optional: true, }, { text: 'D', label: 'Checkout', icon: 'packagebox', }, { text: 'E', label: 'Ordered', icon: 'checkmarkcircle', }, ];
<!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/25.1.3/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/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>
#app { display: flex; flex-direction: column; align-items: center; justify-content: center; row-gap: 16px; height: 580px; min-width: 320px; } .stepper-label { font-weight: 600; } #customStepShape { margin-bottom: 64px; } #customStepShape .dx-step-indicator { border-radius: 4px; } #labelOnly { margin-bottom: 64px; align-items: center; } #labelOnly .dx-step { padding-inline: 2px; } #labelOnly .dx-step-content { padding-block: 4px; } #labelOnly .dx-step-caption { width: auto; max-width: 100%; } #labelOnly .dx-step-label { background-color: var(--dx-color-main-bg); padding-inline: 8px; } #labelOnly .dx-step.dx-state-focused .dx-step-caption { box-shadow: 0 0 0 2px var(--dx-color-main-bg), 0 0 0 4px var(--dx-color-primary), 0 0 0 8px var(--dx-color-main-bg); border-radius: 4px; } #iconOnly { align-items: center; } #iconOnly .dx-step-content { margin-block: 4px; } #iconOnly .dx-icon { box-sizing: content-box; padding: 6px; background-color: var(--dx-color-main-bg); } #iconOnly .dx-state-focused .dx-icon { box-shadow: 0 0 0 2px var(--dx-color-primary), 0 0 0 6px var(--dx-color-main-bg); border-radius: 4px; } #iconOnly :is(.dx-step-selected, .dx-step-completed) .dx-icon { color: var(--dx-color-primary); }