CircularProgressIndicator
CircularProgressIndicator displays determinate or indeterminate progress around a circular track.
Anatomy
| Element | Part | Selector |
|---|---|---|
<div> | root | [data-scope="circular-progress-indicator"][data-part="root"]LMBCopy |
<svg> | svg | [data-scope="circular-progress-indicator"][data-part="svg"]LMBCopy |
<path> | trackconditional | [data-scope="circular-progress-indicator"][data-part="track"]LMBCopy |
<path> | active-indicatorconditional | [data-scope="circular-progress-indicator"][data-part="active-indicator"]LMBCopy |
Props
| Name | Description | Default | Control |
|---|---|---|---|
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
| Token | Description |
|---|---|
--md-progress-indicator-colorColorFallback var(--md-color-on-container, var(--md-sys-color-primary)) | Shared active indicator color for progress indicators. |
--md-progress-indicator-track-colorColorFallback var(--md-color-container, var(--md-sys-color-secondary-container)) | Shared track color for progress indicators. |
--md-circular-progress-indicator-active-indicator-colorColorFallback var(--md-progress-indicator-color) | Active arc color for the circular indicator. |
--md-circular-progress-indicator-track-colorColorFallback var(--md-progress-indicator-track-color) | Track arc color for the circular indicator. |
--md-circular-progress-indicator-sizeLayoutFallback --dp(40) | Default size for the circular indicator. |
--md-circular-progress-indicator-with-wave-sizeLayoutFallback --dp(48) | Default size when using the wavy shape. |
--md-circular-progress-indicator-track-thicknessLayoutFallback --dp(4) | Stroke thickness for track and active arcs. |
--md-circular-progress-indicator-track-active-indicator-gapLayoutFallback --dp(4) | Gap between active arc and track arc. |
--md-circular-progress-indicator-wave-amplitudeWaveFallback --dp(1.6) | Amplitude for the wavy active arc. |
--md-circular-progress-indicator-wave-wavelengthWaveFallback --dp(15) | Wavelength for the wavy active arc. |