Struct MaterialProgress 

pub struct MaterialProgress { /* private fields */ }

Material Design progress indicator component

Progress indicators inform users about the status of ongoing processes, such as loading an app, submitting a form, or saving updates. They communicate an app’s state and indicate available actions.

Usage Examples

// Linear progress with value
ui.add(MaterialProgress::linear()
    .value(0.65)
    .size(Vec2::new(300.0, 6.0)));

// Circular progress with value
ui.add(MaterialProgress::circular()
    .value(0.8)
    .size(Vec2::splat(64.0)));

// Indeterminate linear progress (loading)
ui.add(MaterialProgress::linear()
    .indeterminate(true));

// Buffered linear progress (like video loading)
ui.add(MaterialProgress::linear()
    .value(0.3)
    .buffer(0.6));

// Customized colors and style
ui.add(MaterialProgress::linear()
    .value(0.5)
    .active_color(Color32::RED)
    .track_color(Color32::LIGHT_GRAY)
    .track_gap(4.0)
    .stop_indicator_radius(2.0));

Material Design Spec

• Linear: 4dp height (default), variable width
• Circular: 48dp diameter (default), 4dp stroke width
• Colors: Primary color for progress, secondaryContainer for track
• Animation: Smooth transitions, indeterminate animations
• Corner radius: pill-shaped for linear progress
• Track gap: 4dp between indicator and track (M3 2024)
• Stop indicator: 2dp radius dot at track end (linear determinate)

Implementations

impl MaterialProgress

pub fn new(variant: ProgressVariant) -> Self

Create a new progress indicator with the specified variant

pub fn linear() -> Self

Create a linear progress bar

pub fn circular() -> Self

Create a circular progress indicator

pub fn value(self, value: f32) -> Self

Set the current progress value (clamped between 0.0 and max)

pub fn max(self, max: f32) -> Self

Set the maximum value for progress calculation (default: 1.0)

pub fn buffer(self, buffer: f32) -> Self

Set the buffer value for buffered progress (e.g., video buffering)

pub fn indeterminate(self, indeterminate: bool) -> Self

Enable or disable indeterminate progress animation

pub fn four_color_enabled(self, enabled: bool) -> Self

Enable or disable four-color animation for indeterminate progress

pub fn size(self, size: Vec2) -> Self

Set the size of the progress indicator

pub fn width(self, width: f32) -> Self

Set the width of the progress indicator

pub fn height(self, height: f32) -> Self

Set the height of the progress indicator

pub fn active_color(self, color: Color32) -> Self

Set the indicator/active color (default: theme primary)

pub fn track_color(self, color: Color32) -> Self

Set the track background color (default: theme secondaryContainer)

pub fn buffer_color(self, color: Color32) -> Self

Set the buffer indicator color (default: theme primaryContainer)

pub fn border_radius(self, radius: f32) -> Self

Set the corner radius for linear progress (default: height / 2.0 for pill shape)

pub fn stroke_width(self, width: f32) -> Self

Set the stroke width for circular progress (default: 4.0)

pub fn track_gap(self, gap: f32) -> Self

Set the gap between indicator and track (default: 4.0, set 0 to hide)

pub fn stop_indicator_radius(self, radius: f32) -> Self

Set the stop indicator dot radius for linear determinate (default: 2.0, set 0 to hide)

pub fn stop_indicator_color(self, color: Color32) -> Self

Set the stop indicator dot color (default: theme primary)

pub fn four_color(self, enabled: bool) -> Self

👎Deprecated: Use four_color_enabled() instead

Enable or disable four-color animation (deprecated, use four_color_enabled)

Trait Implementations

impl Widget for MaterialProgress

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.