Angular 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 itemTemplate property to customize all steps in a Stepper. For individual step customization, specify the items[].template property.

Backend API

<div id="label-customStepShape" class="stepper-label">Custom Step Shape</div> <dx-stepper id="customStepShape" [dataSource]="steps" [selectedIndex]="2" [linear]="false" [elementAttr]="{ 'aria-labelledby': 'label-customStepShape' }" > <div *dxTemplate="let data of 'item'"> <div class="dx-step-indicator"> <i class="dx-icon" [class]="'dx-icon-' + data.icon"></i> </div> <div class="dx-step-caption"> <div class="dx-step-label">{{ data.label }}</div> @if (data.optional) { <div class="dx-step-optional-mark">(Optional)</div> } </div> </div> </dx-stepper> <div id="label-labelOnly" class="stepper-label">Label Only</div> <dx-stepper id="labelOnly" [dataSource]="steps" [selectedIndex]="2" [linear]="false" [elementAttr]="{ 'aria-labelledby': 'label-labelOnly' }" > <div *dxTemplate="let data of 'item'"> <div class="dx-step-caption"> <div class="dx-step-label">{{ data.label }}</div> </div> </div> </dx-stepper> <div id="label-iconOnly" class="stepper-label">Icon Only</div> <dx-stepper id="iconOnly" [dataSource]="steps" [selectedIndex]="2" [linear]="false" [elementAttr]="{ 'aria-labelledby': 'label-iconOnly' }" > <div *dxTemplate="let data of 'item'"> <i class="dx-icon" [class]="'dx-icon-' + data.icon" role="img" [attr.aria-label]="data.label" ></i> </div> </dx-stepper>

import { bootstrapApplication } from '@angular/platform-browser'; import { Component, enableProdMode, provideZoneChangeDetection } from '@angular/core'; import { DxStepperModule } from 'devextreme-angular'; import { type DxStepperTypes } from 'devextreme-angular/ui/stepper'; import { AppService } from './app.service'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', templateUrl: './app.component.html', styleUrls: ['./app.component.css'], imports: [ DxStepperModule, ], }) export class AppComponent { steps: DxStepperTypes.Item[]; constructor(private readonly appService: AppService) { this.steps = this.appService.getSteps(); } } bootstrapApplication(AppComponent, { providers: [ provideZoneChangeDetection({ eventCoalescing: true, runCoalescing: true }), AppService, ], });

::ng-deep demo-app { display: flex; flex-direction: column; align-items: center; justify-content: center; row-gap: 16px; height: 580px; min-width: 320px; } ::ng-deep .stepper-label { font-weight: 600; } ::ng-deep #customStepShape { margin-bottom: 64px; } ::ng-deep #customStepShape .dx-step-indicator { border-radius: 4px; } ::ng-deep #labelOnly { margin-bottom: 64px; align-items: center; } ::ng-deep #labelOnly .dx-step { padding-inline: 2px; } ::ng-deep #labelOnly .dx-step-content { padding-block: 4px; } ::ng-deep #labelOnly .dx-step-caption { width: auto; max-width: 100%; } ::ng-deep #labelOnly .dx-step-label { background-color: var(--dx-color-main-bg); padding-inline: 8px; } ::ng-deep #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; } ::ng-deep #iconOnly { align-items: center; } ::ng-deep #iconOnly .dx-step-content { margin-block: 4px; } ::ng-deep #iconOnly .dx-icon { box-sizing: content-box; padding: 6px; background-color: var(--dx-color-main-bg); } ::ng-deep #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; } ::ng-deep #iconOnly .dx-step-selected .dx-icon, ::ng-deep #iconOnly .dx-step-completed .dx-icon { color: var(--dx-color-primary); }

import { Injectable } from '@angular/core'; import { type DxStepperTypes } from 'devextreme-angular/ui/stepper'; @Injectable({ providedIn: 'root', }) export class AppService { steps: DxStepperTypes.Item[] = []; constructor() { this.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', }]; } getSteps(): DxStepperTypes.Item[] { return this.steps; } }

<!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/26.1.5/css/dx.light.css" /> </head> <body class="dx-viewport"> <div class="demo-container"> <demo-app>Loading...</demo-app> </div> <script src="https://cdn.jsdelivr.net/npm/zone.js@0.16.2/bundles/zone.umd.js"></script> <script src="./bundle.js" type="module"></script> </body> </html>