# Step Appearance

The Stepper provides a number of options for customizing the appearance of its steps.

To control the styling, use the following approaches for setting the steps:

<Row>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#indicator-icon">
      <ComponentTitle>Indicator Icon</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Display SVG icons, font icons, or third-party library icons as step indicators.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#indicator-text">
      <ComponentTitle>Indicator Text</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Show custom text inside step indicators instead of default numeric values.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#current-step">
      <ComponentTitle>Current Step</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Specify and control the currently active step using the currentStep property.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#optional-step">
      <ComponentTitle>Optional Step</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Mark steps as optional with a label rendered under the step indicator.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#disabled-step">
      <ComponentTitle>Disabled Step</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Prevent step activation while maintaining keyboard navigation focus.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#step-template">
      <ComponentTitle>Templated Step</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Customize step appearance using templates for advanced scenarios.</ComponentDescription>
    </Component>
  </Column>
</Row>

## Indicator Icon

Depending on the configuration of the project, you can enhance the content of the step by displaying any of the following icon types:

<Row>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#displaying-svg-icons">
      <ComponentTitle>SVG Icons</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Use SVG icons from the Kendo UI icon library as step indicators.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#displaying-font-icons">
      <ComponentTitle>Font Icons</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Display font icons from the Kendo UI theme as step indicators.</ComponentDescription>
    </Component>
  </Column>
  <Column count={[24,24,8]} style={{marginBottom: "1rem"}}>
    <Component className="tile" href="#displaying-font-icons">
      <ComponentTitle>Third-Party Library Icons</ComponentTitle>
      <ComponentDescription style={{padding: "0 10px 10px 10px"}}>Integrate icons from external libraries like FontAwesome or Material Icons.</ComponentDescription>
    </Component>
  </Column>
</Row>

### Displaying SVG Icons

To display an SVG icon inside the step, set the [`svgIcon`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/stepperstep#svgicon) property to the necessary [`SVGIcon`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/svgicon). For details, go to the [list of SVG icons supported by Kendo UI for Angular](https://www.telerik.com/kendo-angular-ui-develop/components/icons/svgicon/svgicon-list).

```html
<kendo-stepper [steps]="steps"> </kendo-stepper>
```

```ts
import { userIcon } from '@progress/kendo-svg-icons';

public steps: StepperStep[] =[{text:'Profile', svgIcon: userIcon}]
```

The following example demonstrates how to set the `svgIcon` property of the Stepper step.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/layout/stepper/basic_usage/source.txt)

### Displaying Font Icons

To display a Font icon inside the Stepper:

1. Use the [`ICON_SETTINGS`](https://www.telerik.com/kendo-angular-ui-develop/components/icons/api/icon_settings) token of the Icons package and set the icon type to `font`. For more information, go to the topic about [icon settings](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon-settings).
2. Depending on the font icons library, you can:
   * set the [`icon`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/stepperstep#icon) property to a font icon in the Kendo UI theme. For details, go to the [list of font icons supported by Kendo UI for Angular](https://www.telerik.com/kendo-angular-ui-develop/components/icons/icon/icon-list).
     ```ts
     public steps: StepperStep[] =[{text:'Profile', icon: 'user'}]
     ```
   * set the [`iconClass`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/stepperstep#iconclass) property to a third-party font icon library (such as [FontAwesome](https://fontawesome.com/)).
     ```ts
     public stepsCustomIcons = [{ label: "Personal Info", iconClass: "fa fa-users fa-fw" }]
     ```
   * use the [stepper indicator template](https://www.telerik.com/kendo-angular-ui-develop/components/layout/stepper/templates#indicator-template) for any other font icon library (for example showing [Google Material Icons](https://fonts.google.com/icons)).
     ```html
     <ng-template kendoStepperIndicatorTemplate let-step>
         <span class="material-icons">{{ step.icon }}</span>
     </ng-template>
     ```

The following example demonstrates how to set the `icon`, and `iconClass` properties of the Stepper step, including Google Material Icons integration.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/layout/stepper/step_appearance/indicator_icons/source.txt)

## Indicator Text

The Stepper allows you to display custom text inside the step indicators instead of the default numeric one.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/layout/stepper/step_appearance/indicator_text/source.txt)

## Current Step

To specify the current step of the Stepper, use the [`currentStep`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/steppercomponent#currentstep) option. The property supports a two-way binding which is provided by the [`currentStepChange`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/steppercomponent#currentStepChange) event.

When the user navigates to a step and activates it either by mouse click or with the keyboard, the Stepper emits a preventable [`activate`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/steppercomponent#activate) event. If prevented, the `currentStep` will remain unchanged.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/layout/stepper/step_appearance/current_step/source.txt)

## Optional Step

You can also mark a step as optional by using the [`optional`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/stepperstep#optional) property. If set to `true`, the step will have an `Optional` label rendered under its indicator.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/layout/stepper/step_appearance/optional_step/source.txt)

## Disabled Step

The Stepper allows you to mark a step as disabled through the [`disabled`](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/stepperstep#disabled) property. Users can focus disabled steps through the keyboard navigation but these steps cannot be activated.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/layout/stepper/step_appearance/disabled_step/source.txt)

## Step Template

For more information about the step templates, refer to the article on the [Stepper templates](https://www.telerik.com/kendo-angular-ui-develop/components/layout/stepper/templates).

## Suggested Links

* [API Reference of the Stepper](https://www.telerik.com/kendo-angular-ui-develop/components/layout/api/steppercomponent)
* [Templates](https://www.telerik.com/kendo-angular-ui-develop/components/layout/stepper/templates)
* [Angular Stepper](https://www.telerik.com/kendo-angular-ui/stepper)
