LinearProgressIndicator
LinearProgressIndicator displays determinate or indeterminate progress on a horizontal track.
Anatomy
| Element | Part | Selector |
|---|---|---|
<div> | root | [data-scope="linear-progress-indicator"][data-part="root"]LMBCopy |
<div> | viewport | [data-scope="linear-progress-indicator"][data-part="viewport"]LMBCopy |
<div> | track | [data-scope="linear-progress-indicator"][data-part="track"]LMBCopy |
<div> | active-indicator | [data-scope="linear-progress-indicator"][data-part="active-indicator"]LMBCopy |
<span> | active-indicator-flat | [data-scope="linear-progress-indicator"][data-part="active-indicator-flat"]LMBCopy |
<svg> | active-indicator-wavyconditional | [data-scope="linear-progress-indicator"][data-part="active-indicator-wavy"]LMBCopy |
<div> | stop-indicatorconditional | [data-scope="linear-progress-indicator"][data-part="stop-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 | 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
| 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-progress-indicator-stop-indicator-colorColorFallback var(--md-progress-indicator-color) | Shared stop indicator color for linear progress. |
--md-linear-progress-indicator-active-indicator-colorColorFallback var(--md-progress-indicator-color) | Active segment color for the linear indicator. |
--md-linear-progress-indicator-track-colorColorFallback var(--md-progress-indicator-track-color) | Track color for the linear indicator. |
--md-linear-progress-indicator-stop-indicator-colorColorFallback var(--md-progress-indicator-stop-indicator-color) | Stop indicator color for determinate linear progress. |
--md-linear-progress-indicator-track-thicknessLayoutFallback --dp(4) | Height of the track and active segment. |
--md-linear-progress-indicator-track-active-indicator-gapLayoutFallback --dp(4) | Gap between active segment and track in determinate partial state. |
--md-linear-progress-indicator-stop-indicator-sizeLayoutFallback --dp(4) | Size of the stop indicator dot. |
--md-linear-progress-indicator-shapeShapeFallback var(--md-shape-indicator) | Corner radius for track, active segment, and stop indicator. |
--md-linear-progress-indicator-wave-amplitudeWaveFallback --dp(3) | Amplitude for the wavy active segment. |
--md-linear-progress-indicator-wave-wavelengthWaveFallback --dp(40) | Wavelength for determinate wavy progress. |
--md-linear-progress-indicator-indeterminate-wave-wavelengthWaveFallback --dp(20) | Wavelength for indeterminate wavy progress. |
--md-linear-progress-indicator-with-wave-heightWaveFallback --dp(10) | Minimum height when using the wavy shape. |