Struct ComboField 

pub struct ComboField {
    pub name: String,
    pub required: bool,
    pub error_messages: HashMap<String, String>,
    pub widget: Widget,
    pub help_text: String,
    pub initial: Option<Value>,
    pub validators: Vec<Box<dyn FormField>>,
}

A field that combines multiple field validators

ComboField runs all provided validators in sequence and requires all to pass.

Examples

use reinhardt_forms::fields::ComboField;
use reinhardt_forms::{Field, CharField, EmailField};
use serde_json::json;

// Create validators with constraints
let mut email_field = EmailField::new("email".to_string());
let mut char_field = CharField::new("email".to_string());
char_field.min_length = Some(5);
char_field.max_length = Some(100);

// Combine email validation with length validation
let field = ComboField::new("email")
    .add_validator(Box::new(email_field))
    .add_validator(Box::new(char_field));

// Valid: passes both email and length checks
let result = field.clean(Some(&json!("user@example.com")));
assert!(result.is_ok());

// Invalid: fails email validation
let result = field.clean(Some(&json!("not-an-email")));
assert!(result.is_err());

// Invalid: too short (less than 5 characters)
let result = field.clean(Some(&json!("a@b")));
assert!(result.is_err());

Fields

name: String

The field name used as the form data key.

required: bool

Whether this field must be filled in.

error_messages: HashMap<String, String>

Custom error messages keyed by error type.

widget: Widget

The widget type used for rendering this field.

help_text: String

Help text displayed alongside the field.

initial: Option<Value>

Optional initial (default) value for the field.

validators: Vec<Box<dyn FormField>>

The list of validator fields that all must pass.

Implementations

impl ComboField

pub fn new(name: impl Into<String>) -> Self

Create a new ComboField

pub fn add_validator(self, validator: Box<dyn FormField>) -> Self

Add a validator field

pub fn required(self, required: bool) -> Self

Set whether this field is required

pub fn help_text(self, text: impl Into<String>) -> Self

Set the help text

pub fn initial(self, value: Value) -> Self

Set the initial value

pub fn error_message( self, error_type: impl Into<String>, message: impl Into<String>, ) -> Self

Set a custom error message

Trait Implementations

impl FormField for ComboField

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 widget(&self) -> &Widget

Returns the widget type used for HTML rendering.

fn required(&self) -> bool

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

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

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

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

Returns optional help text displayed alongside the field.

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