Struct ModelChoiceField 

pub struct ModelChoiceField<T: FormModel> {
    pub name: String,
    pub required: bool,
    pub error_messages: HashMap<String, String>,
    pub widget: Widget,
    pub help_text: String,
    pub initial: Option<Value>,
    pub queryset: Vec<T>,
    pub empty_label: Option<String>,
    /* private fields */
}

A field for selecting a single model instance from a queryset

This field displays model instances as choices in a select widget.

Fields

name: String

required: bool

error_messages: HashMap<String, String>

widget: Widget

help_text: String

initial: Option<Value>

queryset: Vec<T>

empty_label: Option<String>

Implementations

impl<T: FormModel> ModelChoiceField<T>

pub fn new(name: impl Into<String>, queryset: Vec<T>) -> Self

Create a new ModelChoiceField

Examples

use reinhardt_forms::fields::ModelChoiceField;
use reinhardt_forms::FormField;
use reinhardt_forms::FormModel;
use serde_json::{json, Value};

#[derive(Clone)]
struct Category {
    id: i32,
    name: String,
}

impl FormModel for Category {
    fn field_names() -> Vec<String> {
        vec!["id".to_string(), "name".to_string()]
    }

    fn get_field(&self, name: &str) -> Option<Value> {
        match name {
            "id" => Some(json!(self.id)),
            "name" => Some(json!(self.name)),
            _ => None,
        }
    }

    fn set_field(&mut self, _name: &str, _value: Value) -> Result<(), String> {
        Ok(())
    }

    fn save(&mut self) -> Result<(), String> {
        Ok(())
    }
}

let categories = vec![
    Category { id: 1, name: "Technology".to_string() },
    Category { id: 2, name: "Science".to_string() },
];

let field = ModelChoiceField::new("category", categories);
assert_eq!(field.name(), "category");
assert!(FormField::required(&field));

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

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

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

pub fn empty_label(self, label: Option<String>) -> Self

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

Trait Implementations

impl<T: FormModel> FormField for ModelChoiceField<T>

fn name(&self) -> &str

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

fn widget(&self) -> &Widget

fn required(&self) -> bool

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

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

fn clean(&self, value: Option<&Value>) -> FieldResult<Value>

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