Back to Tooljet

Steps

docs/versioned_docs/version-2.62.0/widgets/steps.md

3.20.154-lts3.8 KB
Original Source

Steps

Steps are used to guide users through complex processes, making them easier and more intuitive.

<div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Properties

Steps

This property lets you add and the steps. Every object represents a step.

json
{{
    [
        { name: 'step 1', tooltip: 'some tooltip', id: 1},
        { name: 'step 2', tooltip: 'some tooltip', id: 2},
        { name: 'step 3', tooltip: 'some tooltip', id: 3},
        { name: 'step 4', tooltip: 'some tooltip', id: 4},
        { name: 'step 5', tooltip: 'some tooltip', id: 5}
    ]
}}

Current step

This property lets you select the current step you want to be highlighted.

Steps selectable

This property when disabled will disable selection of steps.

</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Events

<div style={{ width:"100px"}}> Event </div><div style={{ width:"100px"}}> Description </div>
On selectThis event is fired whenever the user selects any step.
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Component Specific Actions (CSA)

There are currently no CSA (Component-Specific Actions) implemented to regulate or control the component.

</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Exposed Variables

<div style={{ width:"100px"}}> Variables </div><div style={{ width:"100px"}}> Description </div><div style={{ width:"135px"}}> How To Access </div>
currentStepIdThis variable holds the id of the currently selected step on the step component.Access the value dynamically using JS: {{components.steps1.currentStepId}}
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

General

Tooltip

A Tooltip is often used to specify extra information about something when the user hovers the mouse pointer over the widget.

Under the <b>General</b> accordion, you can set the value in the string format. Now hovering over the widget will display the string as the tooltip.

</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Layout

<div style={{ width:"100px"}}> Layout </div><div style={{ width:"100px"}}> Description </div><div style={{ width:"135px"}}> Expected Value </div>
Show on desktopToggle on or off to display desktop view.You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}}
Show on mobileToggle on or off to display mobile view.You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}}
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Styles

<div style={{ width:"100px"}}> Style </div><div style={{ width:"100px"}}> Description </div>
ThemeYou can change the theme of widget by selecting available themes from dropdown.
ColourYou can change the color of the widget by entering the Hex color code or choosing a color of your choice from the color picker.
Text colourYou can change the text color of the widget by entering the Hex color code or choosing a color of your choice from the color picker.
VisibilityToggle on or off to control the visibility of the widget. You can programmatically change its value by clicking on the Fx button next to it. If {{false}} the widget will not be visible after the app is deployed. By default, it's set to {{true}}.

:::info Any property having Fx button next to its field can be programmatically configured. :::

</div>