pub struct CircularProgress { /* private fields */ }Expand description
A non-focusable determinate circular progress ring with an optional label.
The ring is centered in the shortest resolved side and begins at 12 o’clock.
With show_label(true) and no custom label, a rounded whole percentage is
generated. A stored custom label is painted even after show_label(false);
there is no builder that clears it.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().value(0.75).show_label(true);
let _ = progress;Implementations§
Source§impl CircularProgress
impl CircularProgress
Sourcepub fn width(self, value: impl Into<Length>) -> Self
pub fn width(self, value: impl Into<Length>) -> Self
Sets preferred width from a logical-pixel or length value.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).width(24.0);
let _ = widget;Sourcepub fn height(self, value: impl Into<Length>) -> Self
pub fn height(self, value: impl Into<Length>) -> Self
Sets preferred height from a logical-pixel or length value.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).height(24.0);
let _ = widget;Sourcepub fn min_width(self, value: impl Into<Length>) -> Self
pub fn min_width(self, value: impl Into<Length>) -> Self
Sets the minimum width bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).min_width(12.0);
let _ = widget;Sourcepub fn max_width(self, value: impl Into<Length>) -> Self
pub fn max_width(self, value: impl Into<Length>) -> Self
Sets the maximum width bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).max_width(32.0);
let _ = widget;Sourcepub fn min_height(self, value: impl Into<Length>) -> Self
pub fn min_height(self, value: impl Into<Length>) -> Self
Sets the minimum height bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).min_height(12.0);
let _ = widget;Sourcepub fn max_height(self, value: impl Into<Length>) -> Self
pub fn max_height(self, value: impl Into<Length>) -> Self
Sets the maximum height bound.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).max_height(32.0);
let _ = widget;Sourcepub fn fill(self) -> Self
pub fn fill(self) -> Self
Sets both preferred axes to parent fill.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).fill();
let _ = widget;Sourcepub fn fill_width(self) -> Self
pub fn fill_width(self) -> Self
Sets preferred width to parent fill.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).fill_width();
let _ = widget;Sourcepub fn fill_height(self) -> Self
pub fn fill_height(self) -> Self
Sets preferred height to parent fill.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).fill_height();
let _ = widget;Sourcepub fn margin(self, value: f32) -> Self
pub fn margin(self, value: f32) -> Self
Sets uniform outer margin in logical pixels.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).margin(4.0);
let _ = widget;Sourcepub fn padding(self, value: f32) -> Self
pub fn padding(self, value: f32) -> Self
Sets uniform inner padding in logical pixels.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).padding(4.0);
let _ = widget;Sourcepub fn flex_grow(self) -> Self
pub fn flex_grow(self) -> Self
Sets flex-grow weight to one.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_grow();
let _ = widget;Sourcepub fn flex_grow_by(self, value: f32) -> Self
pub fn flex_grow_by(self, value: f32) -> Self
Sets a dimensionless flex-grow weight.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_grow_by(2.0);
let _ = widget;Sourcepub fn flex_shrink(self, value: f32) -> Self
pub fn flex_shrink(self, value: f32) -> Self
Sets a dimensionless flex-shrink weight.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_shrink(1.0);
let _ = widget;Sourcepub fn flex_basis(self, value: impl Into<Length>) -> Self
pub fn flex_basis(self, value: impl Into<Length>) -> Self
Sets the preferred main-axis flex basis.
§Examples
use ailloli_ui_core::IconId;
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).flex_basis(20.0);
let _ = widget;Sourcepub fn align_self(self, value: AlignItems) -> Self
pub fn align_self(self, value: AlignItems) -> Self
Overrides cross-axis alignment for this flex item.
§Examples
use ailloli_ui_core::{style::AlignItems, IconId};
use ailloli_ui_widgets::primitives::Icon;
let widget = Icon::new(IconId::Close).align_self(AlignItems::Center);
let _ = widget;Source§impl CircularProgress
impl CircularProgress
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an enabled, empty unlabeled ring over 0.0..=1.0.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new();
let _ = progress;Sourcepub fn value(self, value: impl Into<Binding<f32>>) -> Self
pub fn value(self, value: impl Into<Binding<f32>>) -> Self
Sets a static or reactive value, visually clamped through the domain.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().value(0.25);
let _ = progress;Sourcepub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
pub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
Sets static or reactive disabled state.
Disabled state changes colors and label style; the ring is non-interactive in either state.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().disabled(true);
let _ = progress;Sourcepub fn disabled_signal(self, disabled: Memo<bool>) -> Self
pub fn disabled_signal(self, disabled: Memo<bool>) -> Self
Convenience alias for Self::disabled with a reactive memo.
§Examples
use ailloli_ui_runtime::component::Memo;
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().disabled_signal(Memo::new(|| false));
let _ = progress;Sourcepub fn range(self, min: f32, max: f32) -> Self
pub fn range(self, min: f32, max: f32) -> Self
Replaces range bounds and immediately sanitizes them.
Reversed bounds swap, equal finite bounds try to expand max by 1.0, and
any non-finite bound resets the domain to 0.0..=1.0.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().range(0.0, 100.0).value(75.0);
let _ = progress;Sourcepub fn progress_spec(self, spec: ProgressSpec) -> Self
pub fn progress_spec(self, spec: ProgressSpec) -> Self
Replaces and sanitizes the complete numeric domain.
§Examples
use ailloli_ui_core::ProgressSpec;
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().progress_spec(ProgressSpec::new(10.0, 20.0));
let _ = progress;Sourcepub fn progress_style(self, style: ProgressStyle) -> Self
pub fn progress_style(self, style: ProgressStyle) -> Self
Replaces complete resolved style without clamping its values.
§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{CircularProgress, ProgressSize, ProgressStyle};
let style = ProgressStyle::from_theme(Theme::dark(), ProgressSize::Large);
let progress = CircularProgress::new().progress_style(style);
let _ = progress;Sourcepub fn progress_size(self, size: ProgressSize) -> Self
pub fn progress_size(self, size: ProgressSize) -> Self
Replaces complete style with the default-theme built-in size.
§Examples
use ailloli_ui_widgets::controls::{CircularProgress, ProgressSize};
let progress = CircularProgress::new().progress_size(ProgressSize::Compact);
let _ = progress;Sourcepub fn show_label(self, show: bool) -> Self
pub fn show_label(self, show: bool) -> Self
Controls generated percentage visibility when no custom label exists.
A custom label remains visible regardless of show; call this before
Self::label only to document intent, because label sets it true.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().value(0.5).show_label(true);
let _ = progress; // generated label is "50%"Sourcepub fn label(self, label: impl Into<Binding<String>>) -> Self
pub fn label(self, label: impl Into<Binding<String>>) -> Self
Sets static or reactive custom center text and enables label painting.
Empty text remains a custom label and suppresses generated percentage.
There is no builder to return to None.
§Examples
use ailloli_ui_widgets::controls::CircularProgress;
let progress = CircularProgress::new().value(3.0).range(0.0, 10.0).label("3 / 10");
let _ = progress;