1. Flyology TUI
  2. Components
  3. Spinners

Feedback

Spinners

Show caller-advanced activity without owning time or work.

Generated previewCharm
Dedicated Spinners example rendered in the Charm skin

The site build compiles the dedicated Ada component example, constructs Spinners through its public API, and exports that exact styled surface. Read the capture source.

When to use it

Use a spinner for activity whose completion ratio is unknown. Prefer progress when a useful ratio exists.

State and ownership

The Flyology_TUI.Components.Spinners package defines this component.

The model retains one bounded phase. The application advances the phase from its own tick event.

  • The caller owns the phase and advances it from an application event.
  • The spinner retains no timer or task.

Behavior

Spinners do not take focus or schedule updates.

Integration sequence

  1. Create or update the caller-owned values that the renderer reads.
  2. Borrow the values and appearance required by the selected render function.
  3. Place the returned surface in the current layout. Do not route input to this component.

See the linked package reference for its exact declarations and contracts.

Responsive and accessible behavior

  • Use dimensions and regions from the current layout or presentation value.
  • Retain a glyph, label, border, or text-attribute cue when the terminal reduces color.