rooting-forms 0.3.0

use rooting::{
    El,
};
pub use rooting_forms_proc_macros::Form;

pub struct FormElements {
    /// The error display element, with `CSS_CLASS_ERROR`. This may be placed before
    /// the label in a struct context.
    pub error: Option<El>,
    /// The input, and any additional controls.
    pub elements: Vec<El>,
}

/// An object representing a form (the state of the form).
pub trait FormState<T> {
    /// Parse the elements into the resulting type.
    fn parse(&self) -> Result<T, ()>;
}

/// Provides methods for creating forms from a type. All types that can appear as
/// or within such forms must implement this. This is automatically implemented for
/// `FormWith<()>` so if implementing yourself, focus on that trait.
pub trait Form {
    /// Generates a form state manager to produce form elements and parse the entered
    /// values.
    ///
    /// * `field` - is the field name, for accessibility using `aria-label`. `<label>`
    ///   isn't used sometime due to anonymous fields in tuples.
    ///
    /// * `from` - data used to populate the initial form, for example if creating a form
    ///   to edit existing data.
    fn new_form(field: &str, from: Option<&Self>) -> (FormElements, Box<dyn FormState<Self>>);
}

/// Like `Form` but allows passing in additional context, for custom elements that
/// need it.  `FormWith<()>` is generated by the `Form` derive macro.
pub trait FormWith<C> {
    /// Generates a form state manager to produce form elements and parse the entered
    /// values.
    ///
    /// * `context` - any additional data to be used when generating form states and
    ///   elements. This is forwarded to all nested `new_form` calls.
    ///
    /// See `Form` for the other fields.
    fn new_form_with(context: &C, field: &str, from: Option<&Self>) -> (FormElements, Box<dyn FormState<Self>>) {
        return Self::new_form_with_(context, field, from, 0);
    }
    fn new_form_with_(
        context: &C,
        field: &str,
        from: Option<&Self>,
        depth: usize,
    ) -> (FormElements, Box<dyn FormState<Self>>);
}

impl<T: FormWith<()>> Form for T {
    fn new_form(field: &str, from: Option<&Self>) -> (FormElements, Box<dyn FormState<Self>>) {
        return T::new_form_with(&(), field, from);
    }
}
pub mod css;
pub mod impl_str;
pub mod impl_password;
pub mod impl_bool;
pub mod impl_option;
pub mod impl_unit_structs;
pub mod impl_vec;
pub mod impl_macroutil;
#[cfg(feature = "jiff")]
pub mod impl_jiff;

/// Republished types for macro use.
pub mod republish {
    pub use web_sys::HtmlSelectElement;
}