# `ExRatatui.Widgets.Throbber`
[🔗](https://github.com/mcass19/ex_ratatui/blob/v0.7.1/lib/ex_ratatui/widgets/throbber.ex#L1)

A loading spinner widget that animates through symbol sets.

Uses the `throbber-widgets-tui` Rust crate for rendering. The caller
controls the animation by incrementing the `:step` value (typically
on each tick or timer event).

## Animation sets

The `:throbber_set` option selects the symbol animation:

  * `:braille` (default) — braille dot patterns (⠷ ⠯ ⠟ ⠻ ⠽ ⠾)
  * `:dots` — braille double dots
  * `:ascii` — classic spinner (| / - \)
  * `:vertical_block` — growing vertical block (▁ ▂ ▃ … █)
  * `:horizontal_block` — growing horizontal block (▏ ▎ ▍ … █)
  * `:arrow` — rotating arrow (↑ ↗ → ↘ ↓ ↙ ← ↖)
  * `:clock` — clock emoji animation
  * `:box_drawing` — box-drawing rotation
  * `:black_circle` — rotating black circle
  * `:white_circle` — rotating white circle
  * `:white_square` — rotating white square
  * `:quadrant_block` — quadrant block rotation

## Examples

    iex> alias ExRatatui.Widgets.Throbber
    iex> %Throbber{label: "Loading...", step: 0}
    %Throbber{label: "Loading...", step: 0, throbber_set: :braille, style: %ExRatatui.Style{}, throbber_style: %ExRatatui.Style{}, block: nil}

# `t`

```elixir
@type t() :: %ExRatatui.Widgets.Throbber{
  block: ExRatatui.Widgets.Block.t() | nil,
  label: String.t(),
  step: non_neg_integer(),
  style: ExRatatui.Style.t(),
  throbber_set: throbber_set(),
  throbber_style: ExRatatui.Style.t()
}
```

# `throbber_set`

```elixir
@type throbber_set() ::
  :braille
  | :dots
  | :ascii
  | :vertical_block
  | :horizontal_block
  | :arrow
  | :clock
  | :box_drawing
  | :quadrant_block
  | :white_square
  | :white_circle
  | :black_circle
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*