Struct NumberInput 

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

A text field for a number: typing edits it like a text input, Up and Down step it.

Only digits can be typed, a minus when the range allows negative numbers and a decimal point when the step has decimals. The field shows the invalid state while its text is not a number or lies outside the range, and the application only ever receives valid numbers inside the range; an empty or unfinished field keeps the last valid value. Up and Down move one step and Page Up and Page Down ten, always clamped to the range. Everything else edits like a TextInput: cursor, selection, undo and clipboard.

With NumberInput::steppers two segments on the right step the value when clicked. The wheel over the field moves one step per notch, and a right click opens the text input’s edit menu (Cut, Copy, Paste, Select all); pasted text keeps only the characters a number allows.

Style keys: those of the text input (text-input, text-input-prompt, …) and number-input-stepper (bg, fg) with states hover, focus, pressed, disabled.

Implementations

impl<Msg: 'static> NumberInput<Msg>

pub fn new(value: f64) -> Self

A field showing value, without limits, stepping by 1.

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

The smallest and largest allowed value.

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

How far Up and Down move the value. The step’s decimals decide how the value is written and whether a decimal point can be typed.

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

Shows clickable minus and plus segments on the right.

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

Faint text shown while the field is empty.

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

Marks the value as failing the application’s own validation.

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

Makes the field read-only and unfocusable.

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

Message carrying the new value after every change to a valid number.

Trait Implementations

impl<Msg: 'static> Widget<Msg> for NumberInput<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 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 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 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.