Input Elements


Arclab Web Form Builder supports all common types of input elements.

 

 


 

Captcha (Challenge-Response Test)

A captcha is a human challenge-response-test to spam protect the form from bots and automated submissions.
See also: Captcha

 


 

Single Line Input

The "Single Line Input" is the most important input field in a form. It display a single line text input field.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Numeric Field: If "Numeric Field" is checked, then the form will only accept the chars 0-9.

Min. Length: Min. length of the text input. Enter "0" for no limit. 
Please note, that an empty text input is allowed if "Required Field" is unchecked!

Max. Length: Max. length of the text input. Enter "0" for no limit.

The "Input Error" or "Required" error will be  shown if the user clicks on "Next" or "Submit" and the input is invalid. 
The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

 


 

Dual Single Line Input

The "Dual Single Line Input" displays 2 single line input fields in one line.
See also:  Single Line Input

The "Label" and "Variable Name" can be setup for the "Left Input Element" and the "Right Input Element".

The Variable Name is the name of the Form Element. The varibale name is not shown in the form.

The Label is the name of the field as shown in the form. It can be different from the "Variable Name" or the same.
The Label can contain chars, which are not allowed in the "Variable Name", e.g. :

Optional "Text Description". The description will be shown below the input field(s)
See also: Description and Error Text

"Required Field":  The user must enter a value, otherwise the "Required Field Error Text" will be shown.
Both fields (left and right input field) are the default. You can change it in the section "Layout".

Options:

Numeric Field: If "Numeric Field" is checked, then the form will only accept the chars 0-9.

Min. Length: Min. length of the text input. Enter "0" for no limit. 
Please note, that an empty text input is allowed if "Required Field" is unchecked!

Max. Length: Max. length of the text input. Enter "0" for no limit.

The "Input Error" or "Required" error will be  shown if the user clicks on "Next" or "Submit" and the input is invalid. 
The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

Layout:

The dual single line input offers 2 different layouts:

 

a) Regular Layout ("Label" left of the edit box)

dual layout 1

 

b) Top Layout ("Label" above the edit box)

dual layout 2

 


 

Multi Line Input

The "Multi Line Input" allows the user to enter multiple lines of text, e.g. for notes or a message.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Rows: The number of rows shown in the from.

 


 

Hidden Password Text Input

The "Hidden Password Text Input" is a single-line hidden text input - it's not a password protection for the form (use Password Protection instead).
It can be used as password input e.g. for registration forms.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options


Min Chars: The minimum length of the entered password. Enter "0" for no limit. 
Max Chars: The maximum length of the entered password. Enter "0" for no limit. 

If the entered password is too short or too long, then the "Password Error" will be shown.
Please note, that an empty text input is allowed if "Required Field" is unchecked!

Allowed Chars: Defines the chars allowed in the password entered by the user.

The user must retype the password in a second edit box:
Its recommended to use this option to avoid typos in the password.
Retype Pass: The text shown above the second edit box.

The "Password" or "Required" error will be  shown if the user clicks on "Next" or "Submit" and the input is invalid. 
The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

 


 

Form Password Protection

A simple password protection for the form. The user must enter the password - or one of the alternate passwords - to go to the next form page or submit. The password will be included in the email, so that e.g. a user/group can be identified based on the password.

Options:


Password: Specify the password, e.g. secret. Don't use < or > or & or spaces in the password.

Alternate Passwords: Specify up to 7 alternate passwords.

Important: Don't use < or > or & or spaces in the password(s).  <> and & will be converted to the html entities &lt;&gt; and &amp;

The "Required" error will be  shown if the user clicks on "Next" or "Submit" and the password  is invalid. 
The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

 


 

Email Address Input

The "Email Address Input" is an import input field. It checks the syntax of the entered email address and will show the "Email Error" if the syntax of the entered email address is invalid.

Important: If you define a variable with the name [Email] then the entered email address will be used as sender of the form!

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


The user must retype the email in a second edit box: Its recommended to use this option to avoid typos in the email.
Retype Email: The text shown above the second edit box.

Please note, that an empty email input is allowed if "Required Field" is unchecked!

The "Email" or "Required" error will be  shown if the user clicks on "Next" or "Submit" and the input is invald. 
The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

 


 

Numeric Value (Range)

The "Numeric Value (Range)" is an input field for integers and floats. The value is 0 if the field is empty!

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Min Value: The minimum value. Enter "0" for no limit. 
Max Chars: The maximum value. Enter "0" for no limit. 

The "Min Value" and "Max Value" can be an integer or float. e.g. min: -10 max: 10 / min: 2,50 max: 5,50 / min: 1.19 max: 2.33
Hint: Use 0.0001 if the value should be > 0 !

The "Invalid Value Error" error will be shown if the user clicks on "Next" or "Submit" and the input is invalid.  The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

 


 

Drop Down Selection

The "Drop Down Selection" allows you to specify multiple options. The user can choose a single option.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Text: The text displayed in the form (as option).
Value: The value associated with the text/selection.
Selected: The option is selected by default.

The "Value" can be the same as the "Text", but in some situations you might find it better to use a different value.
Enter the "Text" and click on "Add" to add a new selection. Click on the selection to update, remove or move the selection up/down.

 


 

Language

A "Drop Down Selection" with pre-filled languages of the world.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

World (Countries)

A "Drop Down Selection" with pre-filled countries of the world.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

European Union

A "Drop Down Selection" with pre-filled countries of the EU.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

United States

A "Drop Down Selection" with pre-filled states of the United States of America.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

Bundesländer

A "Drop Down Selection" with pre-filled states of the Germany.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

Selection Field

The selection field is basically the same as a drop-down, but the selection will be highlighted instead of the drop-down.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options


Rows: Height of the selection field.

Text: The text displayed in the form (as option).
Value: The value associated with the text/selection.
Selected: The option is selected by default.

The "Value" can be the same as the "Text", but in some situations you might find it better to use a different value.
Enter the "Text" and click on "Add" to add a new selection. Click on the selection to update, remove or move the selection up/down.

 


 

Multiple Selection Field

A "Selection Field", which allows multiple selections.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Rows: Height of the selection field.

Text: The text displayed in the form (as option).
Value: The value associated with the text/selection.
Selected: The option is selected by default.

The "Value" can be the same as the "Text", but in some situations you might find it better to use a different value.
Enter the "Text" and click on "Add" to add a new selection. Click on the selection to update, remove or move the selection up/down.

 


 

Radio Button Group (Vert)

A group buttons - the user can select a single option (radio-button).

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Text: The text displayed in the form (as radio-button text).
Value: The value associated with the text/selection.
Selected: The radio-button is selected by default.

The "Value" can be the same as the "Text", but in some situations you might find it better to use a different value.
Enter the "Text" and click on "Add" to add a new selection. Click on the selection to update, remove or move the selection up/down.

 


 

Radio Button Group (Horiz)

A group buttons - the user can select a single option (radio-button).

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Text: The text displayed in the form (as radio-button text).
Value: The value associated with the text/selection.
Selected: The radio-button is selected by default.

The "Value" can be the same as the "Text", but in some situations you might find it better to use a different value.
Enter the "Text" and click on "Add" to add a new selection. Click on the selection to update, remove or move the selection up/down.

 


 

Boolean Option

The "Boolean Option Input" is a checkbox. It can be checked or unchecked.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

The "Text Description" will be shown right of the checkbox.

Options:


Field is checked by default: The option is checked on form load.

Unchecked Value and Checked Value:  You can use any value here, e.g. 0 and 1, on and off, true and false, black and white ...

 


 

Required Checkbox

The "Confirmation Option" is a required checkbox. The user must check the field in order to go to the next form page.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

The "Text Description" will be shown right of the checkbox.

The "Required Field" error will be  shown if the user clicks on "Next" or "Submit" and the input is invalid.  The same form page will be displayed again, so that the user can correct the input. The error message will be shown below the input field.

 


 

Day Month Year

"Day Month Year" is a date input field.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Format: Switch between european and US date format.

Start Year and End Year: The date must between the start and end year.

Use runtime date as default: Check this option to select the date at page load as default date.

 


 

Age Verification

"Day Month Year" is a date input field.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Format: Switch between european and US date format.

Start Year and End Year: The date must between the start and end year.

Use runtime date as default: Check this option to select the date at page load as default date.

Min and Max Age: The age of the user must be between the min and max age.

The "Age Verification" error will be  shown if the user clicks on "Next" or "Submit" and the input is invalid, e.g. the user is too young. The same form page will be displayed again, so that the user can correct the input if theree was an error  or leave the page.
The error message will be shown below the input field.

 


 

Day 1-31

A "Drop Down Selection" with pre-filled days (1-31)-

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

Month

A "Drop Down Selection" with pre-filled month (Jan - Dec).

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

Year 1920-today

A "Drop Down Selection" with pre-filled years from 1920 to current year.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

Year today-today+10

A "Drop Down Selection" with pre-filled years from the current year to +10 years.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

 


 

Month Year

"Month Year" is a date input field.

"Variable Name", "Label", "Text Position", Required Field and "Required Error"

Options:


Format: Switch between european and US date format.

Start Year and End Year: The date must between the start and end year.

Use runtime date as default: Check this option to select the date at page load as default date.

 


 

Navigation and Submit Buttons

Each page must contain at least one button.
Please take a look at: Navigation and Submit Buttons for details.