Skip to content

LoadingIndicator

Added in version 0.15.0

Displays pulsating dots to indicate when data is being loaded.

  • Focusable
  • Container

Tip

Widgets have a loading reactive which you can use to temporarily replace your widget with a LoadingIndicator. See the Loading Indicator section in the Widgets guide for details.

Example

Simple usage example:

LoadingApp ● ● ● ● 

from textual.app import App, ComposeResult
from textual.widgets import LoadingIndicator


class LoadingApp(App):
    def compose(self) -> ComposeResult:
        yield LoadingIndicator()


if __name__ == "__main__":
    app = LoadingApp()
    app.run()

Changing Indicator Color

You can set the color of the loading indicator by setting its color style.

Here's how you would do that with CSS:

LoadingIndicator {
    color: red;
}

Reactive Attributes

This widget has no reactive attributes.

Messages

This widget posts no messages.

Bindings

This widget has no bindings.

Component Classes

This widget has no component classes.


textual.widgets.LoadingIndicator class

def __init__(
    self, name=None, id=None, classes=None, disabled=False
):

Bases: Widget

Display an animated loading indicator.

Parameters
Parameter Default Description
name
str | None
None

The name of the widget.

id
str | None
None

The ID of the widget in the DOM.

classes
str | None
None

The CSS classes for the widget.

disabled
bool
False

Whether the widget is disabled or not.