Struct NumberField 

pub struct NumberField { /* private fields */ }

A typed number. While it has focus it shows what is being typed, and without focus the formatted value, such as R$ 1.234,50. Text that is not a number in range stays visible for fixing and leaves the value alone. Up and Down step.

The separators come from crate::Labels, through crate::Localized.

use ravenrs_reactive::State;
use ravenrs_widgets::{NumberField, Ui};

let price = State::new(Some(1234.5));
let field = NumberField::new(price.binding()).decimals(2).range(0.0, 1e9).prefix("R$ ");
let mut ui = Ui::new(field, ravenrs_style::Theme::raven_dark());
ui.update();

Implementations

impl NumberField

pub fn on_leave(self, handler: impl Fn() + 'static) -> Self

Called when the keyboard goes elsewhere after being here.

pub fn new(value: Binding<Option<f64>>) -> Self

A field bound to value, unbounded, with no decimals; None is empty.

pub fn money(cents: Binding<Option<i64>>, prefix: impl Into<String>) -> Self

A field for money held as a whole number of cents: exact, two decimals, showing prefix, such as "R$ ".

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

Accepts only min..=max.

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

How much Up, Down and the buttons change the value. 1 by default.

pub fn decimals(self, decimals: usize) -> Self

Digits shown after the decimal separator without focus. 0 by default.

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

Whether thousands are separated without focus. On by default.

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

Text before the number without focus, such as a currency.

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

Text after the number without focus, such as %.

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

Muted text shown while the field is empty.

pub fn width(self, width: f32) -> Self

Fixed width in logical pixels; by default the field stretches.

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

The name screen readers announce. Inside a crate::FormField, its label is used instead.

pub fn spin_buttons(self) -> Self

Shows buttons that take a step away and add one.

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

Turns the field off: it fades, leaves the tab order and ignores input.

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

Shows the value without letting it change; it can still be focused and read.

Trait Implementations

impl Debug for NumberField

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl View for NumberField

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.