Progress

How far along something is: a line, a circle, a dashboard gauge or a set of steps, with a status the color follows.

Line

A Progress bar fills to percent with the value at its end, and status marks it active, done or failed.

Mini size

Set size="small" for a thinner bar with smaller text, for a narrow column or a table cell.

Size

Set size to a preset, a [width, height] pair or { height } to change a bar's thickness, from a hairline to a thick bar.

Status icons

Set status to "success" or "exception" to show a check or a cross from your icon pack, on bars and circles.

Custom colors

Set strokeColor to any CSS color, like a theme variable, for a state status has no value for, such as a warning.

Gradient

Pass strokeColor a { from, to } pair or percentage stops to fill a bar or a circle with a gradient.

Stroke linecap

Set strokeLinecap to "butt" or "square" for flat ends on a dashboard or circle, in place of the round cap.

Labeled task

Set showInfo={false} and write your own label and status line around the bar, like a file name and time remaining.

Info position

Set percentPosition to put the value inside the bar or at its start or end, and give an inner value a taller size.

Custom format

Pass format a function to write the value your way, like 6 GB or 75 days, and it replaces the status icon too.

Dynamic

Change percent at runtime and the bar and circle animate, turning to success at 100 when no status is set.

Steps

Set steps to split the bar into segments, and pass strokeColor an array to color each segment on its own.

Success segment

Set success.percent to draw a second, darker run inside the bar, like tasks done inside tasks started.

Driven by a slider

A Slider and a Progress bar share one percent state, so dragging the slider fills the bar.

Circle

Set type="circle" for a ring with the value in the middle, or a check or cross when status says so.

Small circles

Set size on a circle to a number or "small" to shrink it, for a card, a list row or a table cell.

Tiny circle

A circle with a size of 20 or less hides its text and shows format in a tooltip, for a status next to a label.

Circle with steps

Pass steps to a circle or dashboard to split the ring, with { count, gap } to set how many segments and how far apart.

Dashboard

Set type="dashboard" for a ring with a gap, and move the gap with gapPlacement or widen it with gapDegree.

In context

The component inside real screens, with the components it usually sits beside.

Upload panel

A sync panel with a bar for each file on its own timer and a circle for the overall progress, where one file fails.

API Reference

Progress
Progress's props. Rows marked antuikit in the Version column are added by the kit.
Line
The props type="line" adds.
Circle
The props type="circle" adds.
Dashboard
The props type="dashboard" adds.