Struct FormField 

pub struct FormField {
    pub name: String,
    pub label: Text,
    pub field_type: String,
    pub options: Value,
    pub rules: Vec<Rule>,
    pub translatable: bool,
    pub help: Option<Text>,
}

One editable field: the column, its label, its field-type key (resolved through the field-type registry), typed options for that type, the validation rules it carries, and whether it holds translatable content. A serde descriptor, so it is authorable as data (later YAML) as well as by builder.

Fields

name: String

label: Text

The field’s label, localized at render. Serde stays a plain string.

field_type: String

The field-type registry key (text, textarea, or a plugin’s vendor.name), resolved to behaviour at render time (see crate::field).

options: Value

Per-type options, typed by the field type. Absent (null) for scalar types.

rules: Vec<Rule>

Validation rules run on submit (see laterite_core::validation).

translatable: bool

Marks a field whose value is translatable content. A reserved seam: the framework stores the value verbatim; a content-translation plugin reads the flag to manage per-locale values.

help: Option<Text>

Help text shown beneath the control, localized at render.

Implementations

impl FormField

pub fn of(name: &str, label: impl Into<Text>, field_type: &str) -> Self

A field of a registered type by key.

pub fn text(name: &str, label: impl Into<Text>) -> Self

pub fn textarea(name: &str, label: impl Into<Text>) -> Self

pub fn reference(name: &str, label: impl Into<Text>, source: &str) -> Self

A reference field: a picker over a registered picker source (a vendor.name key), which the field searches and resolves against. Builds the source option so a descriptor needs no raw JSON.

pub fn select( name: &str, label: impl Into<Text>, options: Vec<(&str, &str)>, ) -> Self

A dropdown over a fixed set of (value, label) choices.

pub fn radio( name: &str, label: impl Into<Text>, options: Vec<(&str, &str)>, ) -> Self

The same choices rendered as radio buttons.

pub fn switch(name: &str, label: impl Into<Text>) -> Self

A checkbox over a boolean column.

pub fn date(name: &str, label: impl Into<Text>) -> Self

A calendar date, stored as YYYY-MM-DD.

pub fn password(name: &str, label: impl Into<Text>) -> Self

A password: hashed on save, never rendered back, and left alone when the field is submitted blank on an edit.

pub fn repeater( name: &str, label: impl Into<Text>, fields: Vec<FormField>, ) -> Self

A list of rows, each holding fields, stored as an array of objects.

pub fn repeater_list( name: &str, label: impl Into<Text>, fields: Vec<FormField>, summary_field: Option<&str>, ) -> Self

A repeater whose rows collapse to the line that names them, opening one at a time. summary_field names the sub-field that titles a row; unset, the first one does.

Use it when a row holds more than one or two fields: rendered inline those become columns, and a row of four is already unreadable. A single narrow column is better left inline, where collapsing would hide the one thing worth seeing.

pub fn options(self, options: Value) -> Self

Sets the field type’s typed options (the type validates them at render).

pub fn required(self) -> Self

Requires a non-empty value in every mode.

pub fn required_on(self, mode: Mode) -> Self

Requires a non-empty value in one mode only (for example a password set on create but left unchanged on edit).

pub fn unique(self) -> Self

Requires the value to be unique in this field’s column (a DB probe that ignores the edited row on update).

pub fn max_length(self, n: usize) -> Self

Caps the value’s length.

pub fn min_length(self, n: usize) -> Self

Requires at least n characters when the value is non-empty.

pub fn email(self) -> Self

Requires a syntactically valid email address.

pub fn translatable(self) -> Self

Marks this field as translatable content (see FormField::translatable).

pub fn help(self, text: impl Into<Text>) -> Self

Help text shown beneath the control.

Trait Implementations

impl Clone for FormField

fn clone(&self) -> FormField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FormField

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FormField

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FormField

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.