Ditto.Generalized.Named

Documentation

input :: (Monad m, FormError input err) => String -> (input -> Either err a) -> (FormId -> a -> view) -> a -> Form m input err view a

used for constructing elements like <input type="text">, which pure a single input value.

inputMaybeReq :: (Monad m, FormError input err) => String -> (input -> Either err a) -> (FormId -> Maybe a -> view) -> Maybe a -> Form m input err view a

used to construct elements with optional initial values, which are still required

inputMaybe :: (Monad m, FormError input err) => String -> (input -> Either err a) -> (FormId -> Maybe a -> view) -> Maybe a -> Form m input err view (Maybe a)

used for elements like <input type="submit"> which are not always present in the form submission data.

inputNoData :: Monad m => String -> (FormId -> view) -> Form m input err view ()

used for elements like <input type="reset"> which take a value, but are never present in the form data set.

inputFile :: forall m input err view. (Monad m, FormInput input, FormError input err) => String -> (FormId -> view) -> Form m input err view (FileType input)

used for <input type="file">

inputMulti

Arguments

:: (FormError input err, FormInput input, Monad m)

=> String

-> [(a, lbl)]

value, label, initially checked

-> (FormId -> [(FormId, Int, lbl, Bool)] -> view)

function which generates the view

-> (a -> Bool)

isChecked/isSelected initially

-> Form m input err view [a]

used for groups of checkboxes, <select multiple="multiple"> boxes

inputChoice

Arguments

:: (FormError input err, FormInput input, Monad m)

=> String

-> (a -> Bool)

is default

-> [(a, lbl)]

value, label

-> (FormId -> [(FormId, Int, lbl, Bool)] -> view)

function which generates the view

-> Form m input err view a

radio buttons, single <select> boxes

inputChoiceForms

Arguments

:: (Monad m, FormError input err, FormInput input)

=> String

-> a

-> [(Form m input err view a, lbl)]

value, label

-> (FormId -> [(FormId, Int, FormId, view, lbl, Bool)] -> view)

function which generates the view

-> Form m input err view a

radio buttons, single <select> boxes

label :: Monad m => String -> (FormId -> view) -> Form m input err view ()

used to create <label> elements

errors

Arguments

:: Monad m

=> ([err] -> view)

function to convert the err messages into a view

-> Form m input err view ()

used to add a list of err messages to a Form

This function automatically takes care of extracting only the errors that are relevent to the form element it is attached to via <++ or ++>.

childErrors :: Monad m => ([err] -> view) -> Form m input err view ()

similar to errors but includes err messages from children of the form as well.

withErrors :: Monad m => (view -> [err] -> view) -> Form m input err view a -> Form m input err view a

modify the view of a form based on its errors