Form.create
Form.create($formId, $formFields) -> object
Description
Create a new Form object with the given $formFields
.
Defining Form Fields
Each form field is defined as a map with these (optional) keys:
rule | Validation rule. (see Input Validation) Default: id |
tag | The HTML tag type of the field (e.g. 'textarea', 'hidden'). If not given, this will be derived from the rule . |
options | A Map or List of input options. Use this if the field type is a select, radio, or checkbox. |
label | The field label. If not given, a title case version of the field name will be used (e.g. 'favoriteColor' = 'Favorite Color') |
placeholder | Optional placeholder for text input fields (not recommended for usability reasons). |
value | Default value of the field. We recommend using the setValues method to dynamically fill in field values. |
Example
$form = Form.create('contactForm', { email: { tag: 'email', }, topic: { tag: 'select', options: { bug: 'Bug Report', feature: 'Feature Request', general: 'General Feedback', } }, message: { tag: 'textarea', rule: 'comment', }, hiddenId: { tag: 'hidden', value: 'abc123', }, })