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:

Outputloading_indicator.py

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.

---

Bases: Widget

Display an animated loading indicator.

Parameters:

Name	Type	Description	Default
name	str | None	The name of the widget.	None
id	str | None	The ID of the widget in the DOM.	None
classes	str | None	The CSS classes for the widget.	None
disabled	bool	Whether the widget is disabled or not.	False

on_input

on_input(event)

Prevent all input events from bubbling, thus disabling widgets in a loading state.