Struct ModelForm 

pub struct ModelForm<T: FormModel> { /* private fields */ }

A form that is automatically generated from a Model

Implementations

impl<T: FormModel> ModelForm<T>

pub fn new(instance: Option<T>, config: ModelFormConfig) -> Self

Create a new ModelForm from a model instance

Examples

use reinhardt_forms::{ModelForm, ModelFormConfig};

let config = ModelFormConfig::new();
let form = ModelForm::new(Some(instance), config);

pub fn empty(config: ModelFormConfig) -> Self

Create a new ModelForm without an instance (for creation)

Examples

use reinhardt_forms::{ModelForm, ModelFormConfig};

let config = ModelFormConfig::new();
let form = ModelForm::<MyModel>::empty(config);

pub fn bind(&mut self, data: HashMap<String, Value>) -> &mut Self

Bind data to the form

Examples

use reinhardt_forms::{ModelForm, ModelFormConfig};
use std::collections::HashMap;
use serde_json::json;

let config = ModelFormConfig::new();
let mut form = ModelForm::<MyModel>::empty(config);
let mut data = HashMap::new();
data.insert("field".to_string(), json!("value"));
form.bind(data);

pub fn is_valid(&mut self) -> bool

Check if the form is valid

Examples

use reinhardt_forms::{ModelForm, ModelFormConfig};

let config = ModelFormConfig::new();
let mut form = ModelForm::<MyModel>::empty(config);
let is_valid = form.is_valid();

pub fn save(&mut self) -> Result<T, FormError>

Save the form data to the model instance

Returns FormError::NoInstance if no model instance is available.

Examples

use reinhardt_forms::{ModelForm, ModelFormConfig};

let config = ModelFormConfig::new();
let mut form = ModelForm::<MyModel>::empty(config);
// Returns Err(FormError::NoInstance) without an instance
assert!(form.save().is_err());

pub fn set_field_value(&mut self, field_name: &str, value: Value)

Set a field value directly on the model instance.

This is used by InlineFormSet to set foreign key values on child instances before saving.

If no instance exists, this method is a no-op.

pub fn form(&self) -> &Form

pub fn form_mut(&mut self) -> &mut Form

pub fn instance(&self) -> Option<&T>