leptos_form

Crates.ioleptos_form
lib.rsleptos_form
version0.2.0-rc1
sourcesrc
created_at2023-11-01 01:04:51.004254
updated_at2024-02-05 21:11:03.832236
descriptionDerive forms from structs.
homepage
repositoryhttps://github.com/tlowerison/leptos_form
max_upload_size
id1020532
size49,792
Trey Lowerison (tlowerison)

documentation

README

leptos_form: Derive leptos forms from rust structs

Crates.io version Download docs.rs docs Unsafe Rust forbidden

Documentation

Features

  • Automatic form parsing -- focus on how your data is represented and not on how to get it in and out of html
  • Easy specification of label and input classes, great for Tailwind integration
  • Labels are derived from struct fields and can be given form-wide casing
  • DOM layout customization through attributes
  • Integration with popular crates

Crate features

This crate offers the following features, all of which are not activated by default:

  • bigdecimal: Provides impls for BigDecimal
  • cache-local-storage: Provides support for writing intermediate form data to/from local storage.
  • cache-serde_json: Provides support for (de)serializing form state as JSON.
  • chrono: Provides impls for DateTime, NaiveDate, NaiveDateTime
  • num-bigint: Provides impls for BigInt and BigUint
  • uuid: Provides impls for Uuid

Example

mod my_crate {
    use leptos::*;
    use leptos_form::prelude::*;
    use serde::*;

    #[derive(Clone, Debug, Default, Deserialize, Form, Serialize)]
    #[form(
        component(
            action = create_my_data(my_data),
            on_success = |DbMyData { id, .. }, _| view!(<div>{format!("Created {id}")}</div>),
            reset_on_success,
        ),
        label(wrap(class = "my-class", rename_all = "Title Case")),
    )]
    pub struct MyData {
        pub my_name: String,
    }

    #[derive(Clone, Debug, Deserialize, Serialize)]
    pub struct DbMyData {
        pub id: i32,
        pub name: String,
    }

    #[component]
    pub fn MyComponent() -> impl IntoView {
        view! {
            <MyData
                initial={MyData::default()}
                top=|| view!(<input type="button" value="Submit" />)
            />
        }
    }

    #[server]
    async fn create_my_data(my_data: MyData) -> Result<DbMyData, ServerFnError> {
        todo!()
    }
}
Commit count: 97

cargo fmt