GitHubopen_in_new

LinearProgressIndicator

LinearProgressIndicator displays determinate or indeterminate progress on a horizontal track.

Anatomy

ElementPartSelector
<div>
root
[data-scope="linear-progress-indicator"][data-part="root"]
left_clickLMBCopy
<div>
viewport
[data-scope="linear-progress-indicator"][data-part="viewport"]
left_clickLMBCopy
<div>
track
[data-scope="linear-progress-indicator"][data-part="track"]
left_clickLMBCopy
<div>
active-indicator
[data-scope="linear-progress-indicator"][data-part="active-indicator"]
left_clickLMBCopy
<span>
active-indicator-flat
[data-scope="linear-progress-indicator"][data-part="active-indicator-flat"]
left_clickLMBCopy
<svg>
active-indicator-wavyconditional
[data-scope="linear-progress-indicator"][data-part="active-indicator-wavy"]
left_clickLMBCopy
<div>
stop-indicatorconditional
[data-scope="linear-progress-indicator"][data-part="stop-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

Drawing direction for the visual indicator.

ltrrtl
"ltr"
shapeOptional

Visual shape of the active indicator.

flatwavy
"flat"
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
-
stopIndicatorOptional

Whether to draw the linear stop indicator at the track end.

boolean | undefined
true
stopIndicatorSizeOptional

CSS length used for the stop indicator size.

string | undefined
-
waveAmplitudeOptional

CSS length used for the wavy active indicator amplitude.

string | undefined
-
wavelengthOptional

CSS length used for the determinate wavy active indicator wavelength.

string | undefined
-
indeterminateWavelengthOptional

CSS length used for the indeterminate 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.

Styling14

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-progress-indicator-stop-indicator-colorColor
Fallbackvar(--md-progress-indicator-color)

Shared stop indicator color for linear progress.

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

Active segment color for the linear indicator.

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

Track color for the linear indicator.

--md-linear-progress-indicator-stop-indicator-colorColor
Fallbackvar(--md-progress-indicator-stop-indicator-color)

Stop indicator color for determinate linear progress.

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

Height of the track and active segment.

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

Gap between active segment and track in determinate partial state.

--md-linear-progress-indicator-stop-indicator-sizeLayout
Fallback--dp(4)

Size of the stop indicator dot.

--md-linear-progress-indicator-shapeShape
Fallbackvar(--md-shape-indicator)

Corner radius for track, active segment, and stop indicator.

--md-linear-progress-indicator-wave-amplitudeWave
Fallback--dp(3)

Amplitude for the wavy active segment.

--md-linear-progress-indicator-wave-wavelengthWave
Fallback--dp(40)

Wavelength for determinate wavy progress.

--md-linear-progress-indicator-indeterminate-wave-wavelengthWave
Fallback--dp(20)

Wavelength for indeterminate wavy progress.

--md-linear-progress-indicator-with-wave-heightWave
Fallback--dp(10)

Minimum height when using the wavy shape.

Examples

Default

Value animation

8%

Indeterminate