Struct Slider

Source
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>

Source

pub fn width(self, value: impl Into<Length>) -> Self

Sets preferred width from a logical-pixel or length value.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().width(120.0);
let _ = widget;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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>

Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;
Source

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;

Trait Implementations§

Source§

impl<A: 'static> Default for Slider<A>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<A: 'static> IntoView<A> for Slider<A>

Source§

fn into_view(self) -> View<A>

Consumes a builder/value and returns its declarative view tree. Read more
Source§

impl<A: 'static> LayoutExt for Slider<A>

Source§

fn layout_mut(&mut self) -> &mut LayoutStyle

Returns the widget’s mutable declarative size/inset state. Read more

Auto Trait Implementations§

§

impl<A> Freeze for Slider<A>

§

impl<A = ()> !RefUnwindSafe for Slider<A>

§

impl<A = ()> !Send for Slider<A>

§

impl<A = ()> !Sync for Slider<A>

§

impl<A> Unpin for Slider<A>

§

impl<A = ()> !UnwindSafe for Slider<A>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T, A> FlexItemExt<A> for T
where T: IntoView<A>,

Source§

fn flex_grow(self) -> View<A>

Sets flex-grow weight to one. Read more
Source§

fn flex_grow_by(self, value: f32) -> View<A>

Sets the dimensionless flex-grow weight. Read more
Source§

fn flex_shrink(self, value: f32) -> View<A>

Sets the dimensionless flex-shrink weight. Read more
Source§

fn flex_basis(self, value: impl Into<Length>) -> View<A>

Sets the preferred main-axis flex basis. Read more
Source§

fn align_self(self, value: AlignItems) -> View<A>

Overrides the parent cross-axis alignment for this view. Read more
Source§

fn fill_width(self) -> View<A>

Marks width as parent-fill in the view size hint. Read more
Source§

fn fill_height(self) -> View<A>

Marks height as parent-fill in the view size hint. Read more
Source§

fn fill(self) -> View<A>

Marks both axes as parent-fill in the view size hint. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T, A> IntoViewKeyExt<A> for T
where T: IntoView<A>,

§

fn key(self, key: impl Into<String>) -> View<A>

Converts self, assigns the owned key, and returns the view. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,