4.11 :: Forms

Description


The <form> and <formItem> element allows you to place forms onto your WAPL pages. This allows you to put search boxes, login forms and anything else you would normally do in a form onto a mobile device.

Quick Example


..snip..
  1.   <row>
  2.   <cell>
  3.   <form>
  4.   <action>http://my-domain/location.htm</action>
  5.   <formItem item_type="text">
  6.   <name>s</name>
  7.   </formItem>
  8.   <formItem item_type="submit">
  9.   <name>Search</name>
  10.   </formItem>
  11.   </form>
  12.   </cell>
  13.   </row>
..snip..

Child Elements


action


This is to be used for forms created using WAPL Web Services. This element defines the destination script to post the form data to. The script should handle _POST and pass the generated WAPL via another SOAP call. The correct markup for the device will then be returned and should be output to the browser.

If you are using a WAPL chunk in Wapple Canvas, see 'url'.

Example:

<form>

    <action>http://your-domain.com/search.htm</action>

</form>

url


If you are using a WAPL chunk within a Wapple Canvas site, this element should be used instead of 'action'. Upon form submission, the form data will be posted to the destination script. This script should handle _POST and output the relevant WAPL. The WAPL chunk will handle the rendering of the WAPL.

Example:

<form>

    <url>http://your-domain.com/search/</url>

</form>

formItem


You can place multiple <formItem> elements into your form in order to generate a functioning form. For more information, please see the section on form items.

Example:

<form>

    <formItem item_type="text">

        <name>searchTerm<name>

        <value><value>

    </formItem>

    <formItem item_type="submit">

        <name>Search<name>

    </formItem>

</form>

Detailed Example


..snip..
  1.   <row>
  2.   <cell>
  3.   <form>
  4.   <action>http://my-domain/location.htm</action>
  5.   <formItem item_type="hidden">
  6.   <name>hidden_field</name>
  7.   <value>xyz</value>
  8.   </formItem>
  9.   <formItem item_type="select">
  10.   <name>select_field</name>
  11.   <possibility>
  12.   <label>Option 1</label>
  13.   <value>1</value>
  14.   </possibility>
  15.   <possibility>
  16.   <label>Option 2</label>
  17.   <value>2</value>
  18.   </possibility>
  19.   </formItem>
  20.   <formItem item_type="text">
  21.   <name>ID</name>
  22.   <value></value>
  23.   <input_mask>*N</input_mask>
  24.   <maxlength>2</maxlength>
  25.   </formItem>
  26.   <formItem item_type="file">
  27.   <label>Upload a file</label>
  28.   <label_class>file_upload</label_class>
  29.   <name>FILE</name>
  30.   </formItem>
  31.   <formItem item_type="checkbox">
  32.   <name>check</name>
  33.   <value>1</value>
  34.   </formItem>
  35.   <formItem item_type="textarea">
  36.   <name>text</name>
  37.   <value>Please enter your text...</value>
  38.   </formItem>
  39.   <formItem item_type="password">
  40.   <name>pass</name>
  41.   <value></value>
..snip..

Contents

Served 294,047,106 API requests
Contact Us