Skip to content


Added in version 0.15.0

Displays pulsating dots to indicate when data is being loaded.

  • Focusable
  • Container


Simple usage example:

LoadingApp ● ● ● ● 

from import App, ComposeResult
from textual.widgets import LoadingIndicator

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

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

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.


This widget posts no messages.


This widget has no bindings.

Component Classes

This widget has no component classes.

textual.widgets.LoadingIndicator class

Bases: Widget

Display an animated loading indicator.