PROGRESS signal
Emits PROGRESS signal.
In-ports
trigger <any>
— triggers PROGRESS signal (hidden if config port is enabled).
config <any>
(dynamic) — accepts a JSON object with configuration properties that can be set at runtime. The output signal is emitted on every config event.
Out-ports
output <Signal>
— emits PROGRESS signal event.
Overview
The PROGRESS signal transmits progress parameters that determine how widgets display progress indicators when a progress bar is enabled. Widgets that support progress bars will react to the PROGRESS signal. However, only widgets with a visible progress bar will display the progress.
The progress state is defined by the PROGRESS signal configuration and can be set either through the Settings dialog or programmatically via the config port.
Progress bars can be displayed in three different modes: Continuous, Incremental, and Incremental Continuous. Each mode is activated, progressed, and completed by a distinct combination of Value
, Total
, and Status
properties.
Settings
Enable realtime config port
If this setting is enabled, the component can be configured through the config port. This port accepts a configuration object as input and allows you to set dynamic properties at runtime. Note that using this port does not cause the component to reinitialize, but it may cause some previous state of the component to be lost.
Display Mode
Progress bars can appear in three modes: Continuous, Incremental, and Incremental Continuous.
- Continuous Mode: No specific
value
ortotal
provided. The progress bar shows an indefinite animation to indicate ongoing activity. - Incremental Mode: Provides both
value
andtotal
where the progress bar displays precise completion status. - Incremental Continuous Mode: Assigning
value
as a number, but leavingtotal
asnull
, allows the bar to move toward completion slowly but never reach the end. Completion only occurs with an explicit "completed" status value.
Value (value
)
Current progress value should be between 0 and Total attribute.
Type: Number
|Null
Required: No
Default:
Total (total
)
Define the total value for the progress. The total
is defaulted to 100 if value
is defined.
Type: Number
|Null
Required: No
Default: 100
Status (status
)
Controls the status of the progress.
Type: String
Required: No
Default: started
- Started (
started
) — progress is started. - Aborted (
aborted
) — progress bar is aborted on current value. - Completed (
completed
) — sets progress bar final value and completes.
Examples
Continuous Progress
This example illustrates a continuous mode where neither value
nor total
is provided. The progress bar will show an ongoing activity animation without any specific progress indication.
{ }
Incremental Progress
In this example, both value
and total
are defined. The progress bar displays the current progress as a specific percentage of completion. Changes to value
will update the display.
// 50% progress
{
"value": 512,
"total": 1024
}
// 50% progress
{
"value": 50
}
{
"status": "completed"
}
Incremental Continuous Progress
These configurations demonstrate incremental continuous mode. The progress bar appears to be moving incrementally but will remain incomplete until explicitly completed by a status
of "completed".
{
"total": null
}