Struct Field 

pub struct Field { /* private fields */ }

One form field binding a lens to the control editing it, offering only that control’s modifiers so a modifier on the wrong control does not compile.

Field::text(lens!(User.name)).placeholder("Ada Lovelace"); // TextField
Field::text(lens!(User.email)).email().unique();
Field::text(lens!(User.age)); // typed: an `i64` column
Field::text(lens!(Post.body)).multiline(6);
Field::choice(lens!(Post.status)).options(Status::options()); // ChoiceField
Field::choice(lens!(Post.author_id)).relationship::<AuthorResource>();
Field::file(lens!(Doc.path)); // FileField
Field::toggle(lens!(Post.featured)); // CustomField

Options belong to a choice: a text field has no options method.

Implementations

impl Field

pub fn text<M, T>(lens: impl Into<Path<M, T>>) -> TextField

where M: Model, T: FormScalar + IntoExpr<T> + 'static,

Binds any FormScalar column, storing the type’s own spelling and probing uniqueness through the lens.

pub fn choice<M, T>(lens: impl Into<Path<M, T>>) -> ChoiceField

where M: Model,

A choice field over any column, with options from options or relationship.

pub fn file<M>(lens: impl Into<Path<M, String>>) -> FileField

where M: Model,

A file field over a String column holding the uploaded path, rendering no value attribute.

pub fn toggle<M>(lens: impl Into<Path<M, bool>>) -> CustomField

where M: Model,

A checkbox over a bool column that submits false when unchecked.

pub fn custom<M, T>( lens: impl Into<Path<M, T>>, control: impl Control + 'static, ) -> CustomField

where M: Model, T: FormScalar,

A field over any FormScalar column, rendered by an app’s Control.

pub fn repeater<M, T>(lens: impl Into<Path<M, List<T>>>) -> RepeaterField

where M: Model, T: RepeaterItem,

A row of T’s controls per item of a #[document] list of T, which the browser adds, removes and moves: a record form’s #[form(repeat)] control.

Each row posts its item’s keys under {key}.{row}.. A resource’s form and an action’s input read them into key’s rows, and a page handling its own post reads it with Schema::read; the items then parse with parse_items.

pub fn text_input<T: FormScalar>(name: impl Into<String>) -> TextField

A text field posting name, a key no column binds: an ActionInput field. T picks the input type, as a column’s type does for Field::text.

pub fn choice_input(name: impl Into<String>) -> ChoiceField

A choice field posting name, a key no column binds, with options from options.

pub fn toggle_input(name: impl Into<String>) -> CustomField

A checkbox posting name, a key no column binds, that submits false when unchecked.

pub fn name(&self) -> &str

The key the field posts: the storage column its path names.

Trait Implementations

impl Debug for Field

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

Formats the value using the given formatter.

impl<F> From<ChoiceField<F>> for Field

fn from(builder: ChoiceField<F>) -> Field

Converts to this type from the input type.

impl<F> From<CustomField<F>> for Field

fn from(builder: CustomField<F>) -> Field

Converts to this type from the input type.

impl<F> From<FileField<F>> for Field

fn from(builder: FileField<F>) -> Field

Converts to this type from the input type.

impl<F> From<RepeaterField<F>> for Field

fn from(builder: RepeaterField<F>) -> Field

Converts to this type from the input type.

impl<F> From<TextField<F>> for Field

fn from(builder: TextField<F>) -> Field

Converts to this type from the input type.

impl IntoSchema for Field

fn into_schema(self) -> Schema