Skip to main content

ProgressBar

A material design linear progress indicator, also known as a progress bar.

A control that shows progress along a line.

There are two kinds of linear progress indicators:

  • Determinate. Determinate progress indicators have a specific value at each point in time, and the value should increase monotonically from 0.0 to 1.0, at which time the indicator is complete. To create a determinate progress indicator, use a non-null value between 0.0 and 1.0.
  • Indeterminate. Indeterminate progress indicators do not have a specific value at each point in time and instead indicate that progress is being made without indicating how much progress remains. To create an indeterminate progress indicator, use a null value.

Examples​

Live example

python/controls/information-displays/progress-bar/progress-bar.py
loading...

Properties​

value​

The value of this progress indicator. A value of 0.0 means no progress and 1.0 means that progress is complete. The value will be clamped to be in the range 0.0 - 1.0.

Defaults to None, meaning that this progress indicator is indeterminate - displays a predetermined animation that does not indicate how much actual progress is being made.

bar_height​

The minimum height of the line used to draw the linear indicator.

Defaults to 4.

border_radius​

The border radius of both the indicator and the track. Border radius is an instance of BorderRadius class.

Defaults to border_radius.all(0) - rectangular shape.

bgcolor​

Color of the track being filled by the linear indicator.

color​

The progress indicator's color.

semantics_label​

The Semantics.label for this progress indicator.

semantics_value​

The Semantics.value for this progress indicator.

tooltip​

The text displayed when hovering the mouse over the control.