Struct MultiValueField 

pub struct MultiValueField {
    pub name: String,
    pub label: Option<String>,
    pub required: bool,
    pub help_text: Option<String>,
    pub widget: Widget,
    pub initial: Option<Value>,
    pub fields: Vec<Box<dyn FormField>>,
    pub require_all_fields: bool,
}

MultiValueField combines multiple fields into one

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.

fields: Vec<Box<dyn FormField>>

The sub-fields that make up this composite field.

require_all_fields: bool

Whether all sub-fields must have values.

Implementations

impl MultiValueField

pub fn new(name: String, fields: Vec<Box<dyn FormField>>) -> Self

Create a new MultiValueField

Examples

use reinhardt_forms::fields::MultiValueField;
use reinhardt_forms::fields::{CharField, IntegerField};
use reinhardt_forms::FormField;
use serde_json::json;

// Create a multi-value field combining name and age
let fields: Vec<Box<dyn FormField>> = vec![
    Box::new(CharField::new("name".to_string())),
    Box::new(IntegerField::new("age".to_string())),
];

let field = MultiValueField::new("person".to_string(), fields);

// Valid: both values provided
let result = field.clean(Some(&json!(["John Doe", 30])));
assert!(result.is_ok());

pub fn compress(&self, values: Vec<Value>) -> FieldResult<Value>

Compresses the cleaned sub-field values into a single value.

Trait Implementations

impl FormField for MultiValueField

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>) -> 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