Struct Form 

pub struct Form { /* private fields */ }

What a form asks for and what writes it.

action is the name the write is reached under, which the repository reads back in ViewLogic::act. args are the values the form carries rather than asks for: a form built per row knows which row it belongs to, and says so here rather than making the reader pick the row again.

Implementations

impl Form

pub fn new(action: impl Into<String>) -> Self

Examples found in repository

examples/library/main.rs (line 763)

    fn loan_form(title: &str) -> Form {
        Form::new("lend-a-book")
            .arg("title", title)
            .field(Field::text("borrower", "Borrower"))
            .field(Field::number("days", "Days out").default(21))
            .field(Field::date("from", "Date lent").default(civil_from_days(today())))
            .field(
                Field::one_of(
                    "condition",
                    "Condition it left in",
                    ["As new", "Good", "Worn"],
                )
                .default("Good"),
            )
    }

pub fn arg(self, key: impl Into<String>, value: impl Display) -> Self

One argument the form carries, which is how a form built per row says which row it belongs to.

It is added to the view’s own arguments on the way to the action, and it is what the action is checked against: a write is refused unless a button on the page offers that action with exactly these arguments. A key the view itself declares as a parameter is refused, since a form that answered one of the page’s own questions would be checked against a different page than the one it is on.

Examples found in repository

examples/library/main.rs (line 764)

    fn loan_form(title: &str) -> Form {
        Form::new("lend-a-book")
            .arg("title", title)
            .field(Field::text("borrower", "Borrower"))
            .field(Field::number("days", "Days out").default(21))
            .field(Field::date("from", "Date lent").default(civil_from_days(today())))
            .field(
                Field::one_of(
                    "condition",
                    "Condition it left in",
                    ["As new", "Good", "Worn"],
                )
                .default("Good"),
            )
    }

pub fn field(self, field: Field) -> Self

Examples found in repository

examples/library/main.rs (line 765)

    fn loan_form(title: &str) -> Form {
        Form::new("lend-a-book")
            .arg("title", title)
            .field(Field::text("borrower", "Borrower"))
            .field(Field::number("days", "Days out").default(21))
            .field(Field::date("from", "Date lent").default(civil_from_days(today())))
            .field(
                Field::one_of(
                    "condition",
                    "Condition it left in",
                    ["As new", "Good", "Worn"],
                )
                .default("Good"),
            )
    }

pub fn fields(self, fields: impl IntoIterator<Item = Field>) -> Self

Trait Implementations

impl Clone for Form

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Form

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

Formats the value using the given formatter.

impl Serialize for Form

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

where __S: Serializer,

Serialize this value into the given Serde serializer.