Quick search

Table Of Contents

Progress Bar

New in version 1.0.8.

_images/progressbar.jpg

The ProgressBar widget is used to visualize progress of some task. Only horizontal mode is supported, vertical mode is not available yet.

The progress bar has no interactive elements, It is a display-only widget.

To use it, simply assign a value to indicate the current progress:

from kivy.uix.progressbar import ProgressBar
pb = ProgressBar(max=1000)

# this will update the graphics automatically (75% done):
pb.value = 750
class kivy.uix.progressbar.ProgressBar(**kwargs)

Bases: kivy.uix.widget.Widget

Class for creating a Progress bar widget.

See module documentation for more details.

max

Maximum value allowed for value.

max is a NumericProperty, default to 100.

value

Current value used for the slider.

value is a AliasProperty, than returns the value of the progressbar. If the value is < 0 or > max, it will be normalized to thoses boundaries.

Changed in version 1.6.0: The value is now limited between 0 to max

value_normalized

Normalized value inside the 0-max to 0-1 range:

>>> pb = ProgressBar(value=50, max=100)
>>> pb.value
50
>>> slider.value_normalized
0.5

value_normalized is an AliasProperty.