Struct Form 

pub struct Form { /* private fields */ }

The reactive form. Cheap to clone (Rc-shared) and 'static, so it can be captured by handlers. Field order is registration order.

Implementations

impl Form

pub fn new(cx: &mut App) -> Self

pub fn field( self, cx: &mut App, name: &'static str, initial: impl Into<String>, ) -> Self

Register a field with an initial value. Each field is a Signal<String>; edits mark it touched, and a field carrying an error re-validates live as it changes.

pub fn rule(self, name: &'static str, validator: Validator) -> Self

Attach a plain Validator to a field. Multiple rules run in order; the first failure wins.

pub fn rule_form(self, name: &'static str, rule: Rule) -> Self

Attach a form-aware Rule (cross-field checks like validators::equals_field).

pub fn signal(&self, name: &str) -> Signal<String>

The field’s value signal — plug it into TextInput::bind and friends. Panics on an unregistered name (a typo you want loud).

pub fn errors(&self) -> Signal<HashMap<&'static str, String>>

The errors signal (field -> message). watch it to re-render on validation changes.

pub fn value(&self, cx: &App, name: &str) -> String

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

pub fn values(&self, cx: &App) -> FormValues

Every field’s current value, keyed by name.

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

The current error for a field, if any.

pub fn touched(&self, name: &str) -> bool

Whether the field has been edited since registration.

pub fn validate_field(&self, cx: &mut App, name: &'static str) -> bool

Run one field’s rules. Returns validity and updates the errors signal.

pub fn validate(&self, cx: &mut App) -> bool

Run every field’s rules (in registration order). Returns whether all passed; the errors signal ends up reflecting exactly this pass.

pub fn is_valid(&self, cx: &App) -> bool

Whether the last validation left no errors.

pub fn submit(&self, cx: &mut App) -> Option<FormValues>

Validate and hand back the values on success — the submit-handler one-liner.

Trait Implementations

impl Clone for Form

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.