Struct DecimalField 

pub struct DecimalField {

    pub name: String,
    pub label: Option<String>,
    pub required: bool,
    pub help_text: Option<String>,
    pub widget: Widget,
    pub initial: Option<Value>,
    pub max_value: Option<f64>,
    pub min_value: Option<f64>,
    pub max_digits: Option<usize>,
    pub decimal_places: Option<usize>,
    pub localize: bool,
    pub locale: Option<String>,
    pub use_thousands_separator: bool,
}

DecimalField for decimal number input with digit and precision validation.

Precision Note: This field stores values internally as f64 (IEEE 754), which provides approximately 15-17 significant decimal digits of precision. All digit count and decimal place validations are performed on the string representation before conversion to f64, ensuring accurate constraint enforcement even for values that cannot be exactly represented in binary floating-point.

For applications requiring exact decimal arithmetic (e.g., financial calculations), consider using rust_decimal::Decimal in your application layer after form validation.

Fields

name: String

The field name used as the form data key.

label: Option<String>

Optional human-readable label for display.

required: bool

Whether this field must be filled in.

help_text: Option<String>

Optional help text displayed alongside the field.

widget: Widget

The widget type used for rendering this field.

initial: Option<Value>

Optional initial (default) value for the field.

max_value: Option<f64>

Maximum allowed value.

min_value: Option<f64>

Minimum allowed value.

max_digits: Option<usize>

Maximum total number of digits allowed.

decimal_places: Option<usize>

Maximum number of digits after the decimal point.

localize: bool

Whether to apply locale-aware formatting.

locale: Option<String>

The locale to use for formatting (e.g., “en_US”).

use_thousands_separator: bool

Whether to display thousands separators.

Implementations

impl DecimalField

pub fn new(name: String) -> Self

Create a new DecimalField

Examples

use reinhardt_forms::fields::DecimalField;

let field = DecimalField::new("price".to_string());
assert_eq!(field.name, "price");
assert!(field.required);

pub fn with_localize(self, localize: bool) -> Self

Enables or disables locale-aware formatting.

pub fn with_locale(self, locale: String) -> Self

Sets the locale for number formatting.

pub fn with_thousands_separator(self, use_separator: bool) -> Self

Enables or disables thousands separator display.

Trait Implementations

impl Clone for DecimalField

fn clone(&self) -> DecimalField

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DecimalField

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

Formats the value using the given formatter.

impl FormField for DecimalField

fn name(&self) -> &str

Returns the field’s name used as the form data key.

fn label(&self) -> Option<&str>

Returns the human-readable label, if set.

fn required(&self) -> bool

Returns whether this field must have a non-empty value.

fn help_text(&self) -> Option<&str>

Returns optional help text displayed alongside the field.

fn widget(&self) -> &Widget

Returns the widget type used for HTML rendering.

fn initial(&self) -> Option<&Value>

Returns the initial (default) value for this field, if any.

fn clean(&self, value: Option<&Value>) -> FieldResult<Value>

Validates and cleans the submitted value, returning the cleaned result.

fn has_changed(&self, initial: Option<&Value>, data: Option<&Value>) -> bool

Check if the field value has changed from its initial value

fn error_messages(&self) -> HashMap<ErrorType, String>

Get custom error messages for this field