Form

Description

Forms act as containers for controls. To go to a new form, use the ChangeForm() function.

To add a Form to your app, choose Add Form from the Project menu at the top of the screen. Forms can be deleted in the Project Explorer.

The information on a form can be submitted to a URL by calling the form.submit() function. The values for all controls on the form which have their Name property defined will be appended to the URL as an HTML query string.

Form Validation

To use a standard jQuery validation library like Parsley.js, you'll need to add this to your code at runtime, for each control that needs to be validated:

$("txtName").attr("data-required", "true")

Properties

Standard properties are supported, plus:

background	Will override the background. background: -webkit-gradient(linear, left top, left bottom, from(#55aaee), to(#003366)); At runtime, you need to force a redraw: Form1.style.background="red" Form1.style.width="100%"
fullscreen	True/False. If True, the form will automatically fill the entire device screen. The IDE will still use height and width at design time.
height	The height of the form in pixels. Default is 460.
left	The left position of the form. Use this for forms that are not full screen.
language	The programming language used in the code for the form. Can be BASIC or JavaScript.
method	Get or Post. The method that the http form is sent by.
openMode	Should the form be open at startup? Use this for forms which are to remain open. There is no need to set this for the first form of the project: that is set in Project Properties.
script	Opens the Code Window for the form.
style	The CSS style for the form.
Url	The URL to be called when the form is submitted using the submit() function.
width	The width of the form in pixels. Default is 320. Percents can be set at runtime.
reset()	Clear all fields on the form. Runtime only.
submit()	Submit the data on the form to the specified URL. Runtime only. See Location as well.

Events

Standard events are supported, plus:

onhide()	Called when form hidden as a result of ChangeForm()
onkeypress(event)	Called when a key is tapped on a form.
onshow()	Called by firstform and when form is shown as a result of ChangeForm()
onsubmit()	Called when a form is submitted.

Example (Basic)

Function btnSendData_onclick()
  Form1.submit()
End Function

To prevent a form from being submitted when the return key is entered in a field:

Function Form1_onsubmit()
  window.event.cancelBubble=True
  window.event.returnValue=False
End Function

To enable scrolling for all forms (this may not play well with scrollable controls):

document.ontouchmove = undefined

To enable scrolling on a single form only:

1. Include iScroll in your extra headers: <script src="iscroll.js"></script>
2. Make sure you are either using jQuery Mobile controls, or have enabled jQuery in the Project Libraries chooser.
3. Put the following code in your Main function:

  Form2.style.height = "460px"  'make the form smaller than its content
  'wrap the form in a div for iScroll, sizing the div to fit the content 
  $("#Form2").wrapInner("<div style='height: 920px'/>") 
  Form2.show()
  ScrollingForm = new iScroll("Form2")  'setup scrolling AFTER we've shown the form

Example (JavaScript)

btnSendData.onclick = function() {
  Form1.submit();
}

To prevent a form from being submitted when the return key is entered in a field:

Form1.onsubmit = function() {
  window.event.cancelBubble=true;
  window.event.returnValue=false;
}

Output

(Url is called with values in the query string)

Related Items

ChangeForm, GetUrlParameter, Properties