Struct FormState 

pub struct FormState { /* private fields */ }

A controlled-form helper. Create one per form (typically stored in a component’s local state / captured by its closures) and bind fields to Input/Textarea/Select/Radio/Checkbox nodes via FormState::field/FormState::checkbox for the current value and FormState::set/FormState::set_checkbox (typically from .on_input/.on_toggle) to write new values back.

Implementations

impl FormState

pub fn new() -> Self

pub fn field(&self, name: &str, default: impl Into<String>) -> Signal<String>

The value signal for string field name, creating it with default on first access. Read this to bind a node’s current value.

pub fn validate(&self, name: &str, f: impl Fn(&str) -> Option<String> + 'static)

Registers a validator for name, run against every new value passed to FormState::set. f returns Some(message) to reject the value (recorded, but the value is still stored — callers can still see what the user typed) or None when it’s valid.

pub fn set(&self, name: &str, value: impl Into<String>)

Sets name’s value (creating the field with an empty default if this is the first write) and re-runs its validator.

pub fn error(&self, name: &str) -> Option<String>

The current validation error for string field name, if any.

pub fn checkbox(&self, name: &str, default: bool) -> Signal<bool>

The boolean field backing a Checkbox, creating it with default on first access.

pub fn set_checkbox(&self, name: &str, value: bool)

Sets boolean field name (creating it if this is the first write).

pub fn is_valid(&self) -> bool

true if every registered string field currently has no validation error. Fields with no validator (or never validated) are always considered valid.

pub fn values(&self) -> HashMap<String, String>

Snapshot of every string field’s current value (e.g. for submission), keyed by field name. Boolean (Checkbox) fields aren’t included — read those individually via FormState::checkbox.

Trait Implementations

impl Clone for FormState

fn clone(&self) -> FormState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for FormState

fn default() -> Self

Returns the “default value” for a type.