Struct Slider 

pub struct Slider<Msg> { /* private fields */ }

A value chosen along a range by moving a knob on a rail.

The value is written before the rail in the accent colour. The done part of the rail is drawn in the accent, the knob ◆ sits at the value and breathes while focused, and the rest of the rail is a quiet raised tone. In ASCII mode the rail is drawn with cell colours instead of glyphs. The widget takes all the width it is given.

Left and Right move one step, Page Up and Page Down a tenth of the range, Home and End jump to the ends. Pressing the rail jumps the knob there and dragging moves it. The mouse wheel over the slider moves one step, up to increase and down to decrease; the slider keeps the wheel, so a scroll view around it does not scroll while the pointer rests on it, and a disabled slider lets the wheel pass. Keyboard jumps step the knob cell by cell over motion.step per cell. The application owns the value.

Style keys: slider (fill, fill-cell, track, knob) and slider-value (fg, bold) with states hover, focus, disabled.

Implementations

impl<Msg> Slider<Msg>

pub fn new(value: f64) -> Self

A slider from 0 to 100 in steps of 1 showing value.

pub fn range(self, min: f64, max: f64) -> Self

The smallest and largest value.

pub fn step(self, step: f64) -> Self

The distance of one step; values snap to steps from the minimum.

pub fn format(self, format: impl Fn(f64) -> String + 'static) -> Self

Writes the value with format instead of the step’s decimals.

pub fn suffix(self, suffix: impl Into<String>) -> Self

Text written right after the value, such as "%" or " ms".

pub fn disabled(self, disabled: bool) -> Self

Greys the slider out; it cannot be focused or moved.

pub fn on_change(self, message: impl Fn(f64) -> Msg + 'static) -> Self

Message carrying the new value whenever the knob moves to another step.

Trait Implementations

impl<Msg: 'static> Widget<Msg> for Slider<Msg>

fn measure(&self, _cx: &mut MeasureCx<'_>, available: Size) -> Size

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn event(&self, cx: &mut EventCx<'_, Msg>, event: &Event) -> bool

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.

fn paint_overlay(&self, _cx: &mut PaintCx<'_>, _anchor: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.