Inner alignment of input field elements.

Data type representing a prebuilt input field. This type is used to determine the structure of a generated form. The form is represented by a [[FieldInfo]] type value. Each FieldInfo value is an individual form element. Inner lists represent the rows of the form. All FieldInfo values in an inner list are rendered besides each other. The outer list represents the columns of the form. Inner lists are rendered below each other.

Examples

Input

[[Single "field1", Single "field2"]]

Renders as:

field1     field2

Input

[[single "field1"], [single "field2"]]

Renders as:

field1

field2

Caution: Not all horizontal alignments work as one would expect. If an element uses inner Alignment parameters, then the next form will only be rendered besides the last form component of the former.

Input

[[listWithoutLabels Vertical 2 []],[listWithoutLabels Vertical 2 []]]

will not result in

list11      list21

list12      list22

but instead in

list11

list12     list21

list22

Generic single choice answer type. Use if you want a 'choose one of multiple' style input without caring about the underlying type.

Same as SingleChoiceSelection, but for multiple choice input.

Wrapper type for generating hidden fields.

Wrapper type for lists. Use for a single field list input.

Members have a basic Yesod field representing Html input fields. A BaseForm instance of type a is needed for generically producing forms for [a] and Maybe a types. An instance can be given manually with the Field constructor or using the convertField function on an existing Field.

Class for generic generation of Html input forms for a given type. Bodyless instances can be declared for any type instancing Generic. Exception: Types with multiple constructors. Use utility functions for those or provide your own instance.

This is the main way to build generic forms. Use in conjunction with FieldInfo builders to generate a form.

Will fail if remaining FieldInfo structure is not empty, indicating the form is faulty.

Examples

formify (Nothing @Int) [[single "Age"]]

Renders an input field with type=number attribute, no default value and label Age.

formify (Just ["Hallo", "Hello", "Hola", "Ciao"]) [[listWithoutLabels Vertical 4 [("class","helloInput")]]]

Renders a series of four input fields, each for the type String and organized vertically beneath each other. They are prefilled with the values given above, are assigned the Css class "helloInput" and have no labels attached to them.

formify
  (Nothing @SingleChoiceSelection)
  [[ buttons
      "Make your choice"
      [ "this one"
      , "or rather that one"
      , "I just can't decide"
      ]
  ]]

Renders a radio button field with the given title and option labels attached. No option is selected when the form is loaded.

like formify, but yields the individual sub-renders instead of a combined form. Retains the layout structure given by the FieldInfo list argument. This can be used in custom forms to incorporate generated inputs.

like formifyComponents, but takes a simple list of FieldInfo values. The sub-renders will also be returned as a flat list without any additional structure.

Retrieve the selected option. Nothing if none.

Retrieve the list of selected options. [] if none.

Value with given list of options selected. The order of list elements is inconsequential.

Value with no options selected.

Value with given number option selected.

Value with no option selected.

Create FieldInfo for a button field. Will turn into either radio buttons or checkboxes depending on the form type. Use with SingleChoiceSelection or MultipleChoiceSelection. Usage with a custom enum type is not recommended due to error proneness.

Same as buttons, but using an explicit enum type. Use this with custom enum types to automatically create labels for all constructors according to the given showing scheme.

Create FieldInfo for a dropdown menu field. Will turn into either single or multiple selection field depending on the form type. Use with SingleChoiceSelection or MultipleChoiceSelection. Usage with a custom enum types is not recommended due to error proneness.

Same as dropdown, but using an explicit enum type. Use this with custom enum types to automatically create labels for all constructors according to the given showing scheme.

Create FieldInfo for a number of fields. Their result will be handled as a list of values.

Same as list, but without using any field labels. Attributes and CSS classes for each field cannot be set with this function. Instead, all fields share the given list of attributes. Use list if individual configuration is required.

Create FieldInfo for a standalone field.

Premade formifyImplementation for types with BaseForm instances. Use within manual instances of Formify.

Same as formifyInstanceBasicField, but for optional fields with Maybe wrapping.

Premade formifyImplementation for "single choice" forms of enum types. Use within manual instances of Formify.

Same as formifyInstanceSingleChoice, but for multiple choice.