Progress Bar
The Horizontal Progress Bar component displays progress in a linear bar format, ideal for visualizing task completion, file uploads, or any process with a defined start and end point.
Example Usage​
A project management dashboard needs to display task completion status for multiple projects. Using the Horizontal Progress Bar component, each project shows its completion percentage with a visual bar that fills from left to right, changing color when the task reaches 100% completion.
Properties​
Property | Description | Expected Value |
|---|---|---|
| Label | Sets how the progress label is displayed. | Select Auto to show the progress percentage, or select Custom to display custom text. |
| Text | Custom text to display as the label. Only visible when Label is set to Custom. | String (e.g., Loading files...). |
| Progress | Sets the progress value of the component. Values are clamped between 0 and 100. | Number (e.g., 50). |
info
Any property having fx button next to its field can be programmatically configured.
Component Specific Actions (CSA)​
The following actions of the component can be controlled using the component-specific actions (CSA). You can trigger these using an event or through a RunJS query.
Action | Description | How To Access |
|---|---|---|
| setValue | Sets the progress value of the component. Values are automatically clamped between 0-100. | components.progressbar1.setValue(75) |
| setVisibility | Sets the visibility of the component. | components.progressbar1.setVisibility(false) |
| setLoading | Sets the loading state of the component. When enabled, the bar shows an animated loading indicator instead of the progress fill. | components.progressbar1.setLoading(true) |
Exposed Variables​
| Variable | Description | How To Access |
|---|---|---|
| value | Holds the current progress value of the component (0-100). | {{components.progressbar1.value}} |
| isVisible | Indicates if the component is visible. | {{components.progressbar1.isVisible}} |
| isLoading | Indicates if the component is in a loading state. | {{components.progressbar1.isLoading}} |
Additional Actions​
Action | Description | Configuration Options |
|---|---|---|
| Visibility | Controls component visibility. | Enable/disable the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
| Loading state | Replaces the progress fill with an animated loading indicator. Often used with isLoading to indicate progress. | Enable/disable the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
| Tooltip | Provides additional information on hover. Supports Plain text, Markdown, and HTML formats. | String (e.g., Task completion status). |
Devices​
Property | Description | Expected Value |
|---|---|---|
| Show on desktop | Makes the component visible in desktop view. | You can set it with the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
| Show on mobile | Makes the component visible in mobile view. | You can set it with the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |