pub struct Slider<A = ()> { /* private fields */ }Expand description
A single-thumb slider over a sanitized [SliderSpec].
value configures controlled input: user interaction only becomes observable
through on_change and the consumer must rebuild/update its source. bind
additionally writes a signal. Display and emitted values are clamped/snapped.
Horizontal values increase rightward; vertical values increase upward.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().range(0.0, 1.0).step(0.1).value(0.5);
let _ = slider;Implementations§
Source§impl<A: 'static> Slider<A>
impl<A: 'static> Slider<A>
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_widgets::layout::Container;
let widget: Container<()> = Container::new().height(40.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_widgets::layout::Container;
let widget: Container<()> = Container::new().min_width(40.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_widgets::layout::Container;
let widget: Container<()> = Container::new().max_width(320.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_widgets::layout::Container;
let widget: Container<()> = Container::new().min_height(24.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_widgets::layout::Container;
let widget: Container<()> = Container::new().max_height(240.0);
let _ = widget;Sourcepub fn fill(self) -> Self
pub fn fill(self) -> Self
Sets both preferred axes to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().margin(8.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_widgets::layout::Container;
let widget: Container<()> = Container::new().padding(8.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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().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_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_basis(80.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;
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().align_self(AlignItems::Center);
let _ = widget;Source§impl<A: 'static> Slider<A>
impl<A: 'static> Slider<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates a horizontal continuous 0.0..=100.0 slider at zero.
It is enabled but read-only until bound or given a change callback.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new();
let _ = slider;Sourcepub fn vertical() -> Self
pub fn vertical() -> Self
Creates a default slider whose value increases bottom-to-top.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::vertical();
let _ = slider;Sourcepub fn value(self, value: impl Into<Binding<f32>>) -> Self
pub fn value(self, value: impl Into<Binding<f32>>) -> Self
Sets static or reactive controlled value and clears bound mode.
Painting clamps/snaps the value; this method does not mutate its source.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().value(150.0);
let _ = slider;Sourcepub fn bind(self, value: impl Into<Signal<f32>>) -> Self
pub fn bind(self, value: impl Into<Signal<f32>>) -> Self
Installs a writable signal for two-way interaction.
Values written by the widget are clamped/snapped and only written when
they differ by more than f32::EPSILON from the displayed value.
§Examples
use std::{cell::RefCell, rc::Rc};
use ailloli_ui_runtime::component::Signal;
use ailloli_ui_widgets::controls::Slider;
let value = Signal::new(Rc::new(RefCell::new(50.0)), Rc::new(|| {}));
let slider: Slider<()> = Slider::new().bind(value);
let _ = slider;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 sliders are not focusable and ignore pointer/keyboard input.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().disabled(true);
let _ = slider;Sourcepub fn disabled_signal(self, disabled: Memo<bool>) -> Self
pub fn disabled_signal(self, disabled: Memo<bool>) -> Self
Sets disabled state from a derived memo.
§Examples
use ailloli_ui_runtime::component::Memo;
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().disabled_signal(Memo::new(|| false));
let _ = slider;Sourcepub fn range(self, min: f32, max: f32) -> Self
pub fn range(self, min: f32, max: f32) -> Self
Sets and sanitizes inclusive minimum/maximum bounds.
Reversed bounds swap; any non-finite bound resets both to 0..=100;
equal bounds are widened upward by one when representable.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().range(-1.0, 1.0);
let _ = slider;Sourcepub fn step(self, step: f32) -> Self
pub fn step(self, step: f32) -> Self
Sets and sanitizes the snapping interval.
A non-positive or non-finite step becomes continuous (None). Valid
values round to the nearest step relative to the minimum.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().step(5.0);
let _ = slider;Sourcepub fn slider_spec(self, spec: SliderSpec) -> Self
pub fn slider_spec(self, spec: SliderSpec) -> Self
Replaces and sanitizes the complete numeric specification.
§Examples
use ailloli_ui_core::SliderSpec;
use ailloli_ui_widgets::controls::Slider;
let slider: Slider<()> = Slider::new().slider_spec(SliderSpec::new(0.0, 10.0).with_step(2.0));
let _ = slider;Sourcepub fn orientation(self, orientation: SliderOrientation) -> Self
pub fn orientation(self, orientation: SliderOrientation) -> Self
Sets horizontal or bottom-to-top vertical orientation.
§Examples
use ailloli_ui_widgets::controls::{Slider, SliderOrientation};
let slider: Slider<()> = Slider::new().orientation(SliderOrientation::Vertical);
let _ = slider;Sourcepub fn slider_style(self, style: SliderStyle) -> Self
pub fn slider_style(self, style: SliderStyle) -> Self
Replaces complete colors and geometry without changing layout size.
Unlike Self::slider_size, this does not rewrite explicit layout
dimensions; intrinsic values apply when layout remains automatic.
§Examples
use ailloli_ui_widgets::controls::{Slider, SliderStyle};
let slider: Slider<()> = Slider::new().slider_style(SliderStyle::default());
let _ = slider;Sourcepub fn slider_size(self, size: SliderSize) -> Self
pub fn slider_size(self, size: SliderSize) -> Self
Replaces style with a default-theme built-in size.
§Examples
use ailloli_ui_widgets::controls::{Slider, SliderSize};
let slider: Slider<()> = Slider::new().slider_size(SliderSize::Compact);
let _ = slider;Sourcepub fn on_change(self, f: impl Fn(f32) -> A + 'static) -> Self
pub fn on_change(self, f: impl Fn(f32) -> A + 'static) -> Self
Maps each changed, clamped/snapped value to an application action.
The callback does not make a controlled value writable; use Self::bind
for two-way state. A later callback builder replaces it.
§Examples
use ailloli_ui_widgets::controls::Slider;
#[derive(Clone)]
enum Action { Changed(f32) }
let slider = Slider::new().on_change(Action::Changed);
let _ = slider;Sourcepub fn on_change_ctx(self, f: impl Fn(&mut EventCtx<A>, f32) + 'static) -> Self
pub fn on_change_ctx(self, f: impl Fn(&mut EventCtx<A>, f32) + 'static) -> Self
Installs a context-aware changed-value handler.
§Examples
use ailloli_ui_widgets::controls::Slider;
let slider = Slider::<()>::new().on_change_ctx(|_ctx, value| assert!(value.is_finite()));
let _ = slider;