pub struct RangeSlider<A = ()> { /* private fields */ }Expand description
A two-thumb slider representing an ordered inclusive subrange.
Source values are clamped, snapped, and ordered for display. Moving a thumb cannot cross the other; both may meet at a zero-width range. Pointer presses choose the nearest thumb (ties choose the end), while keyboard input defaults to the end thumb until another thumb becomes active.
§Examples
use ailloli_ui_core::SliderRangeValue;
use ailloli_ui_widgets::controls::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::new()
.range(0.0, 100.0)
.values(SliderRangeValue::new(20.0, 80.0));
let _ = slider;Implementations§
Source§impl<A: 'static> RangeSlider<A>
impl<A: 'static> RangeSlider<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> RangeSlider<A>
impl<A: 'static> RangeSlider<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates a horizontal 0..=100 slider selecting 25..=75.
It is enabled but read-only until bound or given a change callback.
§Examples
use ailloli_ui_widgets::controls::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::new();
let _ = slider;Sourcepub fn vertical() -> Self
pub fn vertical() -> Self
Creates a default range slider increasing bottom-to-top.
§Examples
use ailloli_ui_widgets::controls::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::vertical();
let _ = slider;Sourcepub fn values(self, values: impl Into<Binding<SliderRangeValue>>) -> Self
pub fn values(self, values: impl Into<Binding<SliderRangeValue>>) -> Self
Sets static or reactive controlled values and clears bound mode.
Display clamps, snaps, and orders endpoints without mutating this source.
§Examples
use ailloli_ui_core::SliderRangeValue;
use ailloli_ui_widgets::controls::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::new().values(SliderRangeValue::new(80.0, 20.0));
let _ = slider;Sourcepub fn bind(self, values: impl Into<Signal<SliderRangeValue>>) -> Self
pub fn bind(self, values: impl Into<Signal<SliderRangeValue>>) -> Self
Installs a writable signal for two-way ordered-range interaction.
§Examples
use std::{cell::RefCell, rc::Rc};
use ailloli_ui_core::SliderRangeValue;
use ailloli_ui_runtime::component::Signal;
use ailloli_ui_widgets::controls::RangeSlider;
let values = Signal::new(Rc::new(RefCell::new(SliderRangeValue::new(20.0, 80.0))), Rc::new(|| {}));
let slider: RangeSlider<()> = RangeSlider::new().bind(values);
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::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::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::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::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::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::new().range(-50.0, 50.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 restores continuous behavior.
§Examples
use ailloli_ui_widgets::controls::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::new().step(10.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::RangeSlider;
let slider: RangeSlider<()> = RangeSlider::new().slider_spec(SliderSpec::new(0.0, 1.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::{RangeSlider, SliderOrientation};
let slider: RangeSlider<()> = RangeSlider::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 intrinsic geometry.
§Examples
use ailloli_ui_widgets::controls::{RangeSlider, SliderStyle};
let slider: RangeSlider<()> = RangeSlider::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::{RangeSlider, SliderSize};
let slider: RangeSlider<()> = RangeSlider::new().slider_size(SliderSize::Compact);
let _ = slider;Sourcepub fn on_change(self, f: impl Fn(SliderRangeValue) -> A + 'static) -> Self
pub fn on_change(self, f: impl Fn(SliderRangeValue) -> A + 'static) -> Self
Maps each changed ordered range to an application action.
The callback does not make a controlled source writable; use Self::bind
for two-way state.
§Examples
use ailloli_ui_core::SliderRangeValue;
use ailloli_ui_widgets::controls::RangeSlider;
#[derive(Clone)]
enum Action { Changed(SliderRangeValue) }
let slider = RangeSlider::new().on_change(Action::Changed);
let _ = slider;Sourcepub fn on_change_ctx(
self,
f: impl Fn(&mut EventCtx<A>, SliderRangeValue) + 'static,
) -> Self
pub fn on_change_ctx( self, f: impl Fn(&mut EventCtx<A>, SliderRangeValue) + 'static, ) -> Self
Installs a context-aware ordered-range handler.
§Examples
use ailloli_ui_widgets::controls::RangeSlider;
let slider = RangeSlider::<()>::new()
.on_change_ctx(|_ctx, range| assert!(range.start <= range.end));
let _ = slider;