Struct EmailField 

pub struct EmailField {
    pub name: String,
    pub label: Option<String>,
    pub required: bool,
    pub help_text: Option<String>,
    pub widget: Widget,
    pub initial: Option<Value>,
    pub max_length: Option<usize>,
    pub min_length: Option<usize>,
}

Available on crate feature forms and non-WebAssembly only.

Email field with format 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_length: Option<usize>

Maximum allowed character count (defaults to 320 per RFC).

min_length: Option<usize>

Minimum required character count.

Implementations

impl EmailField

pub fn new(name: String) -> EmailField

Create a new EmailField with the given name

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("email".to_string());
assert_eq!(field.name, "email");
assert!(!field.required);
assert_eq!(field.max_length, Some(320));

pub fn required(self) -> EmailField

Set the field as required

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("contact".to_string()).required();
assert!(field.required);

pub fn with_max_length(self, max_length: usize) -> EmailField

Set the maximum length for the field

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("email".to_string()).with_max_length(100);
assert_eq!(field.max_length, Some(100));

pub fn with_min_length(self, min_length: usize) -> EmailField

Set the minimum length for the field

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("email".to_string()).with_min_length(5);
assert_eq!(field.min_length, Some(5));

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

Set the label for the field

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("contact_email".to_string()).with_label("Email Address");
assert_eq!(field.label, Some("Email Address".to_string()));

pub fn with_help_text(self, help_text: impl Into<String>) -> EmailField

Set the help text for the field

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("email".to_string()).with_help_text("We'll never share your email");
assert_eq!(field.help_text, Some("We'll never share your email".to_string()));

pub fn with_initial(self, initial: impl Into<String>) -> EmailField

Set the initial value for the field

Examples

use reinhardt_forms::fields::EmailField;

let field = EmailField::new("email".to_string()).with_initial("user@example.com");
assert_eq!(field.initial, Some(serde_json::json!("user@example.com")));

Trait Implementations

impl Clone for EmailField

fn clone(&self) -> EmailField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmailField

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

Formats the value using the given formatter.

impl FormField for EmailField

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>) -> Result<Value, FieldError>

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