ToolJet/docs/versioned_docs/version-2.35.0/widgets/steps.md
Asjad Ahmed Khan b472ad8861
[docs]: Fixed the spellings in the docs (#9420)
* fixed the spellings in the docs

* enhanced the components section of the docs
2024-04-22 13:24:56 +05:30

3.8 KiB

id title
steps Steps

Steps

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

Properties

Steps

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

{{
    [
        { 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.

Events

<div style={{ width:"100px"}}> Event <div style={{ width:"100px"}}> Description
On select This event is fired whenever the user selects any step.

Component Specific Actions (CSA)

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

Exposed Variables

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

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 General accordion, you can set the value in the string format. Now hovering over the widget will display the string as the tooltip.

Layout

<div style={{ width:"100px"}}> Layout <div style={{ width:"100px"}}> Description <div style={{ width:"135px"}}> Expected Value
Show on desktop Toggle 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 mobile Toggle on or off to display mobile view. You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}}

Styles

<div style={{ width:"100px"}}> Style <div style={{ width:"100px"}}> Description
Theme You can change the theme of widget by selecting available themes from dropdown.
Colour You 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 colour You 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.
Visibility Toggle 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. :::