Skip to main content

Progress

This page provides information on using the Progress widget, which is used to visualize the progression of specific operations and user or system-triggered actions.

How to use Progress Widget

Content properties​

These properties are customizable options present in the property pane of the widget, allowing users to modify the widget according to their preferences.

Basic​

Infinite loading boolean​

Enables the widget to enter an infinite loading state, which is beneficial when the progress values cannot be determined. For instance, this property can be enabled for queries that take a longer time to execute.

Type string​

Allows you to select the desired format for the progress bar.

Options:

  • Circular
  • Linear

Progress number​

Specify the value of the progress indicator (in percentage). You can also use values retrieved from queries or JavaScript functions within the mustache operator {{}}.

General​

Number of steps number​

Specify the number of steps to break down the progress bar into multiple parts with fixed progress percentages. This property only supports positive integers.

Visible boolean​

Controls the visibility of the widget. If you turn off this property, the widget would not be visible in View Mode. Additionally, you can use JavaScript by clicking on JS next to the Visible property to conditionally control the widget's visibility.

For example, if you want to make the widget visible only when the user selects "Yes" from a Select widget, you can use the following JavaScript expression: 

{{Select1.selectedOptionValue === "Yes"}}

Show result boolean​

Control the display of the evaluated percentage as a number along with the progress in the widget.

Counterclockwise boolean​

Specifies whether the circular progress bar should animate in a counterclockwise direction. This option is only available when the Circular progress Type is selected.

Style properties​

Style properties allow you to change the look and feel of the widget.

Fill color string​

Specify the color of the progress bar. It accepts CSS color values and can also be programmatically modified using JavaScript functions.

Reference properties​

These properties are not available in the property pane, but can be accessed using the dot operator in other widgets or JavaScript functions. For instance, to get the visibility status, you can use Progress1.isVisible.

progress number​

Indicates the current progress of the progress bar as a percentage.

Example:

{{Progress1.progress}}

isVisible boolean​

The isVisible property indicates the visibility state of a widget, with true indicating it is visible and false indicating it is hidden.

Example:

{{Progress1.isVisible}}

Methods​

The methods provided by the widget allow users to dynamically update and manipulate its properties, facilitating the creation of dynamic and interactive applications without the need for manual property modifications.

These methods are asynchronous and return a Promise. You can use the .then() block to ensure execution and sequencing of subsequent lines of code in Appsmith.

setVisibility (param: boolean): Promise​

Sets the visibility of the widget.

Example:

Progress1.setVisibility(true)

setProgress (param: number): Promise​

Sets the progress value of the Progress widget.

Example:

Progress1.setProgress(50)