The Form Element

The form element represents an html <form> and is the first object you create in the content pane.

Create a form by clicking 'Create Form' in the 'Add New Element' menu:

Then edit the attributes for the form

and click the 'Create' button.

ID

ID is the document object model identifier for the form. The important thing to remember about any id you assign is to make it unique among all the elements in the form.

Name

Name is typically used in form fields to provide your form processing script with a way to identify what response a form user gave for each field (data is sent as a name=value pair). Although name doesn't apply in this context for forms and is typically not used, the attribute is included here to allow those who want to specify it (for use in client-side scripts for example) the option to do so.

(See the documentation for the Admin Pane for details on how to remove the name attribute as an editable field.)

Action

Action should be set to the url of your form processing script. Set Action to an absolute url (http://www.yoursite.com/script.php) rather than a relative url (script.php) to allow you to test your script from the formArchitect editor.

Method

Method describes the manner in which your form data is passed to your form processing script. Choosing 'Get' will pass the data as name=value pairs appended as a querystring to the url you specify in Action, while 'Post' will send the data in a message body (typically as an array/hash).

In any case, your form processing script will retrieve the data from your form differently depending on which method is chosen. Consult the documentation for your scripting language for details on how this is accomplished.

Encoding

Set Encoding to 'FileUpload' only if you're including file upload input elements (Text Boxes in formArchitect) in your form. Otherwise, choose 'Default'.

Form Width

Set Form Width to the available width (in pixels) in your web page that you want your form to occupy. This is the only place in formArchitect where you'll set an absolute width, the widths of all other elements in the form are set/modified based on the width you specify here.

Editing / Deleting a Form

The "Edit Form" form is the same as the "Add New Form" form except that the current values for each attribute are filled in. Edit these attributes as you wish then click the 'Save' button at the bottom of the form to save your changes.

To delete the form, click the "Start New Form" link at the bottom of the "Add New Element" menu: