Activity Indicator#

A small animated indicator showing activity on a task of indeterminate length, usually rendered as a “spinner” animation.

../../../_images/ActivityIndicator.jpeg
Availability (Key)#

macOS

GTK

Windows

iOS

Android

Web

●

●

Usage#

import toga

indicator = toga.ActivityIndicator()

# Start the animation
indicator.start()

# Stop the animation
indicator.stop()

Notes#

  • The ActivityIndicator will always take up a fixed amount of physical space in a layout. However, the widget will not be visible when it is in a “stopped” state.

Reference#

class toga.widgets.activityindicator.ActivityIndicator(id=None, style=None, running=False)#

Create a new ActivityIndicator widget.

Inherits from Widget.

Parameters:

  • id – The ID for the widget.

  • style – A style object. If no style is provided, a default style will be applied to the widget.

  • running – Describes whether the indicator is running at the time it is created.

property enabled#

Is the widget currently enabled? i.e., can the user interact with the widget?

ActivityIndicator widgets cannot be disabled; this property will always return True; any attempt to modify it will be ignored.

focus()#

No-op; ActivityIndicator cannot accept input focus

property is_running#

Determine if the activity indicator is currently running.

Use start() and stop() to change the running state.

True if this activity indicator is running; False otherwise.

start()#

Start the activity indicator.

If the activity indicator is already started, this is a no-op.

stop()#

Stop the activity indicator.

If the activity indicator is already stopped, this is a no-op.