4.10 :: 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

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