Skip to content
HuxerUIHuxerUIHuxerUI

ProgressCircle

Construct ProgressCircle() for ongoing work with unknown completion, or pass a normalized progress value for determinate work.

Choose progress mode

Section titled “Choose progress mode”
Row {
  ProgressCircle(),
  Text("Connecting"),
  ProgressCircle(progress),
  Text::Format("{}%", static_cast<int>(progress * 100.0F)),
}.With(
    Spacing(10.0F),
    CrossAlign(CrossAxisAlignment::Center)
)

Progress is controlled by the caller. Passing State<float> reads its current value; update the state to supply the next progress.

Semantics and motion

Section titled “Semantics and motion”

The component exposes progress-indicator semantics. Determinate mode reports its range value, while indeterminate mode communicates busy progress without inventing a percentage.

ProgressCircleStyle controls size, stroke width, track and indicator colors, track gap, indeterminate motion, arc fractions, and animation duration. Reduced-motion themes suppress or simplify continuous motion.

API

Section titled “API”
  • Constructors: ProgressCircle(), ProgressCircle(float), ProgressCircle(State<float>).
  • Common modifiers: Frame, Opacity, Semantics for an application-specific label.
  • Theme style: ProgressCircleStyle and ProgressCircleIndeterminateMotion.

Use ProgressBar when the available width should communicate progress along a linear track.