Struct ProgressBar

pub struct ProgressBar {
    pub value: f32,
    pub fill: Color,
}

A linear progress indicator for determinate operations.

Renders a horizontal track with a coloured fill from the left edge to value × width. value is clamped to [0.0, 1.0] at construction. For indeterminate progress (the operation has no ETA) prefer an animated spinner — ltk has no built-in spinner widget yet; build one from a Container that rotates a glyph while crate::App::is_animating returns true.

// In view():
column()
    .push( text( format!( "Downloading… {}%", ( self.progress * 100.0 ) as u32 ) ) )
    .push( progress_bar( self.progress ) )
.into()

Fields

value: f32

Current progress in [0.0, 1.0]. Always clamped at construction.

fill: Color

Fill colour. Defaults to the theme’s accent palette slot.

Implementations

impl ProgressBar

pub fn new(value: f32) -> Self

Create a progress bar at the given fraction. value outside [0.0, 1.0] is clamped silently.

pub fn color(self, color: Color) -> Self

Override the fill colour. Useful for “danger” / “success” variants (red for nearly-full disks, green for completed work).

pub fn preferred_size(&self, max_width: f32) -> (f32, f32)

Return the preferred (width, height). Width fills the available max_width; height is the theme-defined row height.

pub fn draw(&self, canvas: &mut Canvas, rect: Rect)

Trait Implementations

impl<Msg: Clone> From<ProgressBar> for Element<Msg>

fn from(p: ProgressBar) -> Self

Converts to this type from the input type.