Struct FormErrors 

pub struct FormErrors { /* private fields */ }

The problems of a form, in the order the application found them, each under the name of the control it belongs to.

Validation stays in the application: it checks its values and records a message for every problem. Use the same name for the error and the control’s NodeMut::id, so FormErrors::focus_first can take the user to the first problem.

use qframe::widgets::FormErrors;

let name = "ab";
let mut errors = FormErrors::new();
errors.check("name", name.chars().count() >= 3, "Use at least 3 characters");
assert_eq!(errors.get("name"), Some("Use at least 3 characters"));
assert_eq!(errors.first(), Some("name"));

Implementations

impl FormErrors

pub fn new() -> Self

No problems.

pub fn set(&mut self, name: impl Into<String>, message: impl Into<String>)

Records message for control name, replacing an earlier message for it.

pub fn check( &mut self, name: impl Into<String>, valid: bool, message: impl Into<String>, )

Records message for name when valid is false and forgets any problem of name when it is true.

pub fn remove(&mut self, name: &str)

Forgets the problem of name.

pub fn clear(&mut self)

Forgets every problem.

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

The message for name, if it has a problem.

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

Whether name has a problem.

pub fn is_empty(&self) -> bool

Whether there are no problems.

pub fn len(&self) -> usize

How many problems there are.

pub fn first(&self) -> Option<&str>

The name of the first problem.

pub fn iter(&self) -> impl Iterator<Item = (&str, &str)>

Every problem as (name, message), in order.

pub fn focus_first<Msg: Send + 'static>(&self) -> Command<Msg>

Moves focus to the control of the first problem; nothing when there are none.

Trait Implementations

impl Clone for FormErrors

fn clone(&self) -> FormErrors

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FormErrors

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

Formats the value using the given formatter.

impl Default for FormErrors

fn default() -> FormErrors

Returns the “default value” for a type.

impl Eq for FormErrors

impl PartialEq for FormErrors

fn eq(&self, other: &FormErrors) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FormErrors