GitHubopen_in_new

CircularProgressIndicator

CircularProgressIndicator displays determinate or indeterminate progress around a circular track.

Anatomy

ElementPartSelector
<div>
root
[data-scope="circular-progress-indicator"][data-part="root"]
left_clickLMBCopy
<svg>
svg
[data-scope="circular-progress-indicator"][data-part="svg"]
left_clickLMBCopy
<path>
trackconditional
[data-scope="circular-progress-indicator"][data-part="track"]
left_clickLMBCopy
<path>
active-indicatorconditional
[data-scope="circular-progress-indicator"][data-part="active-indicator"]
left_clickLMBCopy

Props

NameDescriptionDefaultControl
indeterminateOptional

Whether the progress value is unknown.

boolean | undefined
false
valueOptional

Current progress value.

number | undefined
0
minOptional

Minimum progress value.

number | undefined
0
maxOptional

Maximum progress value.

number | undefined
1
directionOptional

Direction used to draw the active indicator.

clockwisecounterclockwise
"clockwise"
shapeOptional

Visual shape of the active indicator.

flatwavy
"flat"
sizeOptional

CSS length used for the component size.

string | undefined
-
thicknessOptional

CSS length used for the track and active indicator thickness.

string | undefined
-
trackGapOptional

CSS length used for the gap between active indicator and track.

string | undefined
-
waveAmplitudeOptional

CSS length used for the wavy active indicator amplitude.

string | undefined
-
wavelengthOptional

CSS length used for the wavy active indicator wavelength.

string | undefined
-
ariaLabelOptional

Accessible label.

string | undefined
-
-
ariaValueTextOptional

Accessible value text. Defaults to a percentage for determinate progress.

string | undefined
-
-

Events0

No events documented.

Slots0

No slots documented.

Styling10

TokenDescription
--md-progress-indicator-colorColor
Fallbackvar(--md-color-on-container, var(--md-sys-color-primary))

Shared active indicator color for progress indicators.

--md-progress-indicator-track-colorColor
Fallbackvar(--md-color-container, var(--md-sys-color-secondary-container))

Shared track color for progress indicators.

--md-circular-progress-indicator-active-indicator-colorColor
Fallbackvar(--md-progress-indicator-color)

Active arc color for the circular indicator.

--md-circular-progress-indicator-track-colorColor
Fallbackvar(--md-progress-indicator-track-color)

Track arc color for the circular indicator.

--md-circular-progress-indicator-sizeLayout
Fallback--dp(40)

Default size for the circular indicator.

--md-circular-progress-indicator-with-wave-sizeLayout
Fallback--dp(48)

Default size when using the wavy shape.

--md-circular-progress-indicator-track-thicknessLayout
Fallback--dp(4)

Stroke thickness for track and active arcs.

--md-circular-progress-indicator-track-active-indicator-gapLayout
Fallback--dp(4)

Gap between active arc and track arc.

--md-circular-progress-indicator-wave-amplitudeWave
Fallback--dp(1.6)

Amplitude for the wavy active arc.

--md-circular-progress-indicator-wave-wavelengthWave
Fallback--dp(15)

Wavelength for the wavy active arc.

Examples

Default

Value animation

8%

Indeterminate