Sun Java System Portal Server Mobile Access 7.1 Developer's Reference

Chapter 9 Abstract Markup Language (AML) Elements

This chapter provides an explanation of each of the AML elements.

Table 9–1 is a summary list of AML elements. The table contains two columns. The first column lists the AML element name, and the second column provides a summary of the element. For a full description of the AML elements, find the element you want listed alphabetically following the table.

Abstract Markup Language (AML) Elements

Table 9–1 Summary of Abstract Markup Language (AML) Elements


AML Element Name	Summary
AmlBr	The `AmlBr` element is a break element.
AmlCheckBox	The `AmlCheckBox` element is a standard checkbox element that is either selected or not selected.
AmlChoice	The `AmlChoice` element is a standard choice element that contains one or more options that can be selected.
AmlContainer	The `AmlContainer` element allows device specific markup—or any other type of text—to pass by the rendering engine to be interpreted directly by the browser.
AmlControlMenu	The `AmlControlMenu` element is an individual menu item that is a link to a URL.
AmlDocument	The `AmlDocument` element is the root level element.
AmlForm	The `AmlForm` element is a standard form element.
AmlGroup	The `AmlGroup` element is a Group Element.
AmlImage	The `AmlImage` element is an image Element.
AmlInput	The `AmlInput` element is a standard input field element.
AmlLink	The `AmlLink` element is a standard URL link element.
AmlList	The `AmlList` element is a standard List element.
AmlListItem	The `AmlListItem` element is a standard ListItem.
AmlOption	The `AmlOption` element is a standard option element.
AmlOrderedList	The `AmlOrderedList` element is a standard Ordered List.
AmlPage	The `AmlPage` element is the primary container element.
AmlParam	The `AmlParam` element is used to specify a URL parameter for `AmlURL`.
AmlPCData	This element has been deprecated. The AmlText element has replaced the AmlPCData element. The AmlPCData element is used to place text on display.
AmlSelectList	The `AmlSelectList` element is a standard selection list element.
AmlSelectListItem	The `AmlSelectListItem` element is a standard selection list item element.
AmlSpace	The `AmlSpace` element is a standard text element for inserting spaces.
AmlStyle	The `AmlStyle` element is a Style Extension.
AmlTable	The `AmlTable` element is a standard table element.
AmlTableCol	The `AmlTableCol` element is a standard table column element.
AmlTableHead	This element has been deprecated. The `AmlTableHead` element is a standard table head element.
AmlTableRow	The `AmlTableRow` element is a standard table row element.
AmlText	The `AmlText` element is a standard text element.
AmlTextArea	The `AmlTextArea` element is a standard textarea input field element.
AmlURL	The `AmlURL` element is a standard URL link element with parameters specified.

AML Description Details

AML Attribute Table

Each of the AML elements from the preceding table is explained in this chapter. For each element, the explanation includes a table that provides information about the element’s attributes. These tables contain five columns. The first column lists the attributes, if any; the second column provides a description of each attribute; the third column lists the possible values of each attribute, the fourth column gives the default value of each attribute; and the fifth column indicates if the attribute is required. Within the AML attribute tables, some attributes have the term CDATA—for character data in the Possible Values column. The term CDATA is a World Wide Web Consortium (W3C) recommendation for XML that refers to any text which is not markup.

Markup Language Examples

In this chapter, every explanation of an AML element includes examples of related markup. For each element, the first example demonstrates the use of AML input. The second and third examples are of corresponding output in the following markup languages: WML (Wireless Markup Language) and cHTML (compact Hypertext Markup Language)

AmlBr

Description

The AmlBr element is used to separate other elements that are displayed. The AmlBr element has no attributes.

Element Body

((AmlContainer)*)

Parent

AmlPage, AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
None	Not Applicable	Not Applicable	Not Applicable	Not Applicable

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage title=”Hello World Page”>
		<AmlText text=”Hello World!”/>
		<AmlBr/>
		<AmlText text="The rest of the story."/>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version=”1.0”?>
<!DOCTYPE wml PUBLIC “-//WAPFORUM//DTD WML 1.1//EN”
“http://www.wapforum.org/DTD/wml_1.1.xml”>
<wml>
	<head>
		<meta http-equiv=”Cache-Control” content=”max-age=0”/>
	</head>
	<card id=”agp0”>
		<p align=”center”>Hello World Page</p>
		<p>
		Hello World!<br/> The rest of the story.
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name=”PalmComputingPlatform” content=”true”></meta>
		<meta http-equiv=”Pragma” content=”no-cache”></meta>
		<meta http-equiv=”Cache-Control” content=”no-cache”></meta>
	</head>
	<body>
		<div align=”center”>
			<a name=”agp0”>Hello World Page</a>
		</div>
		Hello World!<br/> The rest of the story.
	</body>
</html>

AmlCheckBox

Description

An AmlCheckBox element is either selected or not selected. The name attribute’s value holds the variable name for the boolean value. The AmlCheckBox element can be added to an AmlForm object.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
name	Boolean variable holding value	CDATA	No Default	Yes
selected	Selection status	(true\|false)	false	No
select_label	Label for selected form input	CDATA	No Default	No
unselect_label	Label for unselected form input	CDATA	No Default	No
view	Set view option	(show\|hidden\|none)	show	No
persist	Set persist flag	(true\|false)	false	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Deprecated	(true\|false)	false	No
text	Deprecated	CDATA	No Default	No
textsize	Deprecated	(big\|normal\|small)	normal	No
value	Value used as form input	CDATA	No Default	No

Markup Language Examples

Sample AML Input:

<?xml version="1.0" encoding="ISO-8859-6"?>
<AmlDocument>
	<AmlPage>
		<AmlForm url="nextAction">
		<AmlCheckBox name="midp">
		<AmlText text="MIDP"/>
		</AmlCheckBox>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
	<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<card id="agp0">
		<p align="center"></p>
		<p mode="nowrap">
		MIDP
		<select name="midp" value="no"> 
			<option value="yes">yes</option>
			<option value="no">no</option>
		</select>
		</p>
		<do label="submit" type="accept">
			<go href="nextAction?midp=$(midp)" sendreferer="true" method="get"/>
		</do>
</card>
</wml>

Sample cHTML Output:

<html>
<head>
	<title></title>
	<meta name="PalmComputingPlatform" content="true"></meta>
	<meta http-equiv="Pragma" content="no-cache"></meta>
	<meta http-equiv="Cache-Control" content="no-cache"></meta>
</head>
<body>
	<div align="center">
		<a name="agp0"></a>
	</div>
	<form enctype="application/x-www-form-urlencoded" action="nextAction" method="get">
		<input name="midp" type="checkbox"></input>MIDP<br> 
		<input name="request" type="sub	mit" value="Submit"></input>
	</form>
</body>
</html>

AmlChoice

Description

An AmlChoice is a list of AmlOptions available for selection. The item selected becomes the value of the variable in the name attribute. An AmlText serves as the label of the AmlChoice. An example of an AmlChoice is a list of Countries where users select one to convey where they live.

Element Body

((AmlContainer*, AmlText?, AmlOption+, AmlStyle?)

Parent

AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
name	Set name used for form input	CDATA	No Default	No
mode	Single or Multiple selection	(multiple\|single)	single	No
view	Set view option	(show\|hidden\|none)	show	No
wml_select_label	Set the label for submit for WML	CDATA	No Default	No
cache	Set caching	(true\|false)	true	No
persist	Set persist flag	(true\|false)	false	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Deprecated	(true\|false)	false	No
text	Deprecated	CDATA	No Default	No
textsize	Deprecated	(big\|normal\|small)	normal	No
scroll_size	Deprecated	CDATA	No Default	No
value	Value used as form input	CDATA	No Default	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Choice Test">
	<AmlPage title="Choices">
		<AmlForm url="resources">
			<AmlChoice name="c1">
			<AmlOption value="o1" text="o1"/>
			<AmlOption value="o2" text="o2"/>
			</AmlChoice>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0"><p align="center">Choices</p>
		<p mode="nowrap">
		<select multiple="false" name="c1">
			<option value="o1" title="select">o1</option>
			<option value="o2" title="select">o2</option>
		</select>
		</p>
		<do label="submit" type="accept">
			<go href="resources?c1=$(c1)" sendreferer="true" method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
<head>
		<title>Choice Test</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
</head>
<body>
		<div align="center">
			<a name="agp0">Choices</a>
		</div>
		<form enctype="application/x-www-form-urlencoded"
		action="resources" method="get">
			<select name="c1"><option value="o1">o1</option>
			<option value="o2">o2</option>
			</select><br>
		<input name="request" type="submit" value="Submit"></input>
		</form>
</body>
</html>

AmlContainer

Description

An AmlContainer element contains text that is not passed through the rendering engine; therefore, the text appears on browsers in the original format, for example, in javascript or in a native markup language, such as WML. You can add an AmlContainer element to any element that accepts an AmlText element.

Element Body

Empty

Parent

AmlDocument, AmlPage, AmlChoice, AmlOption, AmlForm, AmlTable, AmlTableRow, AmlTableCol, AmlTableHead, AmlInput, AmlLink, AmlControlMenu, AmlTextArea, AmlCheckBox, AmlText, AmlBr, AmlImage, AmlGroup, AmlListItem, AmlSelectListItem, AmlOrderedList, AmlList, AmlSelectList, AmlSpace

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
persist	Set persist flag.	(true\|false)	false	No
text	Set text in container			No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Welcome">
	<AmlPage title="Script">
		<AmlContainer text="&ltbr/&gt;"/> </AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<card id="agp0">
		<p align="center">Script</p>
			<br/> </card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">Script</a>
		</div><br/>
	</body>
</html>

AmlControlMenu

Description

An AmlControlMenu is an individual menu item that is a link to a URL. An AmlControlMenu is added to an AmlPage. All AmlControlMenus added to a page are gathered and placed together in a common location to form the menu.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
url	Set URL for `AmlControlMenu`	CDATA	No Default	Yes
label	Deprecated	CDATA	No Default	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Deprecated	(true\|false)	false	No
text	Deprecated	CDATA	No Default	No
textsize	Deprecated	(big\|normal\|small)	normal	No
key	Set selection key	(options\|accept\|prev)	options	No

Markup Language Examples

Sample AML Input:

<?xml version="1.0" encoding="ISO-8859-6"?>
<AmlDocument>
	<AmlPage>
		<AmlControlMenu url="http://watchita" label="hehe" key="accept"/
		<AmlText text="Moon watchers in North America can see the lunar eclipse." />
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<card id="agp0">
		<p align="center"></p>
			<do label="hehe" name="hehe" type="accept">
			<go href="http://watchita" sendreferer="true"/>
			</do> <p>Moonwatchers in North America
			can see the lunar eclipse.</p>
</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0"></a>
		</div>
			<div><a href="http://watchita">hehe</a>
			</div> Moonwatchers in North America can see the lunar eclipse.
	</body>
</html>

AmlDocument

Description

The AmlDocument is the root level element. An AmlDocument must contain one or more AmlPage elements.This element normally has only a title attribute.

Element Body

(AmlContainer*, AmlPage+, AmlStyle?)

Parent

None

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
encoding	Set encoding on document	CDATA	No Default	Yes
title	Set title displayed on device	CDATA	No Default	No
titlecolor	Set the titlecolor	Color name or numeric value	No Default	No
textsize	Set textsize on document	(big\|normal\|small)	normal	No
italics	Set title to italics	(true\|false)	false	No
bold	Set title to bold	(true\|false)	false	No
underline	Set title to underlined	(true\|false)	false	No
halign	Set halign for title	(left\|right\|center)	center	No
font	Font to be used	CDATA	No Default	No
blink	Set title to blink	(true\|false)	false	No
marquee	Set title to marquee	(true\|false)	false	No
bgcolor	Set background color of document	Color name or numeric value	No Default	No
textcolor	Set textcolor for document	Color name or numeric value	No Default	No
linkcolor	Set linkcolor of document	Color name or numeric value	No Default	No
prev_label	Set previous label for document	CDATA	No Default	No
next_label	Set next label for document	CDATA	No Default	No
refresh	Set refresh url for document	CDATA	No Default	No
refresh_timeout	Set refresh timeout for document	CDATA	No Default	No
markup_headers	Set markup headers for particular browser	CDATA	No Default	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Welcome"> <AmlPage title="Login">
	<AmlForm url="Validate">
		<AmlText text="User Name"/>
		<AmlInput name="user"/>
		<AmlBr/>
		<AmlText text="Password"/>
		<AmlInput name="pin"/>
	</AmlForm>
</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml> <head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Login</p>
		<p>
			User Name
			<input emptyok="true" name="user"/><br/>
			Password
			<input emptyok="true" name="pin"/>
		</p>
		<do label="submit" type="accept">
			<go href="Validate?user=$(user)&amp;pin=$(pin)"
			sendreferer="true" method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head> <body>
	<div align="center">
	<a name="agp0">Login</a>
	</div>
	<form enctype="application/x-www-form-urlencoded" action="Validate" method="get">
	User Name
	<input name="user"></input><br>Password<input name="pin"></input><br>
	<input name="request" type="submit" value="Submit"></input>
	</form>
</body>
</html>

AmlForm

Description

An AmlForm is a standard input form added to an AmlPage. This element is used to hold user input elements. When its Submit button is clicked, entered values are accepted and control is transferred to the URL in its URL attribute.

Element Body

Parent

Amlpage, AmlGroup

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
url	Set submit URL for form	CDATA	No Default	Yes
encoding	Set encoding on form’s parameters	CDATA	No Default	No
inputs	Deprecated. `AmlInputs` are automatically handled	CDATA	No Default	No
method	Set method type for form	(get\|post)	get	No
cache	Set caching flag	(true\|false)	true	No
view	Set summary style for HDML protocol	(summary\|linked)	summary	No
submit_label	Set label for button submitting form contents	CDATA	No Default	No
reset	Set reset attribute on AmlForm	(true\|false)	false	No
reset_label	Set label for button resetting form contents	CDATA	No Default	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage>
		<AmlForm>
			<AmlURL action="Zapper">
			<AmlParam name="a" value="z"/>
			<AmlParam name="b" value="x"/>
			</AmlURL>
			<AmlText text="Enter name"/>
			<AmlInput name="n"/>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center"></p>
		<p>Enter name<input emptyok="true" name="n"/></p>
		<do label="submit" type="accept">
		<go href="Zapper?a=z&amp;b=x&amp;n=$(n)" sendreferer="true"
		method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0"></a>
		</div>
			<form enctype="application/x-www-form-urlencoded" 
						  			action="Zapper" method="get">
			<input name="a" type="hidden" value="z"></input>
			<input name="b" type="hidden" value="x"></input>Enter name
			<input name="n"></input><br>
			<input name="request" type="submit" value="Submit"></input>
			</form>
	</body>
</html>

AmlGroup

Description

An AmlGroup element is a group element for elements that enter into a design together. The developer can use one element for the members of the Group. The objects in the group are added as descendents.

Element Body

Parent

AmlPage, AmlForm, AmlTableCol

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
halign	Horizontal alignment setting	(left\|right\|center)	No Default	No
valign	Vertical alignment setting	(top\|middle\|bottom)	No Default	No
mode	Mode setting	(wrap\|nowrap)	No Default	No
cache	Set cache flag	(true\|false)	true	No
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Company Document">
	<AmlPage title="Company Page" bold="true">
		<AmlGroup halign="center" valign="top">
		<AmlText bold="true" text="Welcome to Company"/>
	<AmlImage src="Logo" alt="Company Logo"/>
		</AmlGroup>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0">
		<p align="center">Company Page</p>
			<p align="center">
			<b>Welcome to Company</b>
			<img alt="Company Logo" src="Logo" align="bottom"/>
			</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Company Document</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Company Page</b>
			</a>
		</div>
		<div align="center">
		<b>Welcome to Company</b>
		<img alt="Company Logo" src="Logo" align="bottom"> </div> </body>
</html>

AmlImage

Description

An AmlImage element is used to add an image to most AML presentation elements.

Element Body

((AmlContainer)*, AmlStyle?)

Parent

AmlPage, AmlOption, AmlForm, AmlTableCol, AmlTableHead, AmlInput, AmlLink, AmlControlMenu, AmlTextArea, AmlCheckBox, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
src	Set src of image	CDATA	No Default	Yes
alt	Set alt text of image	CDATA	No Default	Yes
align	Set alignment of the image	(top\|middle\|bottom\|left\|right)	bottom	No
height	Set height of image	CDATA	No Default	No
width	Set width of image	CDATA	No Default	No
vspace	Set vspace of image	CDATA	No Default	No
hspace	Set hspace of image	CDATA	No Default	No
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Company Document">
	<AmlPage title="Login " bold="true">
		<AmlImage src="Logo" alt="Company Logo"/>
		<AmlForm>
			<AmlURL action="Validate"/>
			<AmlText bold="true" text="User"/>
			<AmlInput name="user"/>
			<AmlText bold="true" text="PIN"/>
			<AmlInput name="pin"/>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Login </p>
		<p>
		<img alt="Company Logo" src="Logo" align="bottom"/>
		</p>
		<p>
			<b>User</b>
			<input emptyok="true" name="user"/>
			<b>PIN</b>
			<input emptyok="true" name="pin"/>
		</p>
		<do label="submit" type="accept">
			<go href="Validate?user=$(user)&amp;pin=$(pin)"
			sendreferer="true" method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Company Document</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
		<a name="agp0">
			<b>Login </b>
		</a>
		</div>
		<img alt="Company Logo" src="Logo" align="bottom">
		<form enctype="application/x-www-form-urlencoded"
		action="Validate" method="get">
		<b>User</b>
		<input name="user"></input>
		<b>PIN</b>
		<input name="pin"></input><br>
		<input name="request" type="submit" value="Submit"></input>
		</form>
	</body>
</html>

AmlInput

Description

An AmlInput element is a text input field where the user can enter up to maxchars characters. The content input by the user becomes the value of the variable whose name is the value of the name attribute.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
name	Set name of the textfield	CDATA	No Default	Yes
type	Set type of textfield data	CDATA	No Default	No
value	Set value of textfield	CDATA	No Default	No
view	Set view option for textfield	(show\|hidden\|none)	show	No
format	Set format of textfield	CDATA	No Default	No
maxchars	Set max characters of the input textfield	CDATA	No Default	No
width	Set width of textfield	CDATA	No Default	No
italics	Set italics emphasis	(true\|false)	false	No
bold	Set bold emphasis	(true\|false)	false	No
underline	Set underline emphasis	(true\|false)	false	No
text	Set text for label	CDATA	No Default	No
textsize	Set size of text	(big\|normal\|small)	normal	No
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage id="p1" title="Login" bold="true">
		<AmlForm url="Validate">
			<AmlInput text="Username:" maxchars="30" name="user"/>
			<AmlInput text="PIN:" maxchars="10" name="pin"/>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="p1">
		<p align="center">Login</p>
			<p>
			Username:
			<input emptyok="true" name="user" maxlength="30"/>
			PIN:
			<input emptyok="true" name="pin" maxlength="10"/>
			</p>
		<do label="submit" type="accept">
		<go href="Validate?user=$(user)&amp;pin=$(pin)"
		sendreferer="true" method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="p1"><b>Login</b></a>
		</div>
		<form enctype="application/x-www-form-urlencoded"
		action="Validate" method="get">
		Username:
		<input name="user" maxlength="30"></input>
		PIN:
		<input name="pin" maxlength="10"></input><br>
		<input name="request" type="submit" value="Submit"></input>
		</form>
	</body>
</html>

AmlLink

Description

An AmlLink is used to place active text or image links on an AmlPage, AmlTableCol, or AmlForm. The URL attribute is the URL of the destination.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlPage, AmlForm, AmlTableCol, AmlGroup, AmlListItem, AmlSelectListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
url	Set url for link.	CDATA	No Default	Yes
selected_color	Set color of selected link	CDATA	No Default	No
italics	Set italics for link text	(true\|false)	false	No
bold	Set bold for link text	(true\|false)	false	No
underline	Set underline for link text.	(true\|false)	false	No
text	Set text for link	CDATA	No Default	No
textsize	Set text size for link	(big\|normal\|small)	normal	No
wml_select_label	Set the label for submit for wml	CDATA	No Default	No
persist	Set persist flag for link	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage title="Company Page" bold="true">
		<AmlText bold="true" text="Welcome to Company"/>
			<AmlLink url="documents">
			<AmlText text="Documents"/>
			</AmlLink>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0"><p align="center">Company Page</p>
		<p>
			<b>Welcome to Company</b>
			<a href="documents">Documents</a>
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Company Page</b>
			</a>
		</div>
				<b>Welcome to Company</b>
				<a href="documents">Documents</a>
	</body>
</html>

AmlList

Description

An AmlList is a standard bulleted List.

Element Body

(AmlContainer*, AmlText?, AmlListItem+, AmlStyle?)

Parent

AmlPage, AmlForm, AmlTableCol, AmlGroup

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
bullet	Set the bullet type	(disc\|square\|circle)	circle	No
indent	Set the indentation string	CDATA	No Default	No
cache	Set the caching	(true\|false)	true	No
persist	Set the persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Welcome">
	<AmlPage title="Chooser" bold="true">
		<AmlList>
		<AmlListItem>
		<AmlText text="Running"/>
		</AmlListItem>
		<AmlListItem>
		<AmlText text="Jumping"/>
		</AmlListItem>
		<AmlListItem>
		<AmlText text="Skipping"/>
		</AmlListItem>
		</AmlList>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Chooser</p>
		<p> o Running<br/> o
		Jumping<br/> o Skipping<br/>
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Chooser</b>
			</a>
			</div>
		<ul type="circle"> <li>Running</li>
		<li>Jumping</li> <li>Skipping</li>
		<ul>
	</body>
</html>

AmlListItem

Description

An AmlListItem is a standard list item. An AmlListItem can be an item in an AmlOrderedList or an AmlList. An AmlListItem has no attributes.

Element Body

Parent

AmlList,AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
None	Not Applicable	Not Applicable	Not Applicable	Not Applicable

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Welcome">
	<AmlPage title="Chooser" bold="true">
		<AmlList>
		<AmlListItem>
		<AmlText text="Running"/>
		</AmlListItem>
		<AmlListItem>
		<AmlText text="Jumping"/>
		</AmlListItem>
		<AmlListItem>
		<AmlText text="Skipping"/>
		</AmlListItem>
		</AmlList>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Chooser</p>
		<p>
		o Running<br/> o Jumping<br/> o
		Skipping<br/> </p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Chooser</b>
			</a>
		</div>
		<ul type="circle">
			<li>Running</li>
			<li>Jumping</li>
			<li>Skipping</li>
		</ul>
	</body>
</html>

AmlOption

Description

An AmlOption can be added to an AmlChoice list. When added, the AmlOption becomes the bottom member of the list.

Element Body

((AmlContainer*, (AmlImage | AmlText)?, AmlStyle? )

Parent

AmlChoice

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
url	Set url for option	CDATA	No Default	No
value	Set the value for the option	CDATA	No Default	No
selected	Set as selected among several options	(true\|false)	false	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Deprecated	(true\|false)	false	No
text	Set text for the option	CDATA	No Default	No
textsize	Deprecated	Deprecated	normal	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Option Test">
	<AmlPage title="Choices">
		<AmlForm url="resources">
			<AmlChoice name="c1">
				<AmlOption value="o1" text="o1"/>
				<AmlOption value="o2" text="o2"/>
			</AmlChoice>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0"><p align="center">Choices</p>
		<p mode="nowrap">
			<select multiple="false" name="c1">
			<option value="o1" title="select">o1</option>
			<option value="o2" title="select">o2</option>
			</select>
		</p>
		<do label="submit" type="accept">
			<go href="resources?c1=$(c1)" sendreferer="true" method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Option Test</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">Choices</a>
		</div>
		<form enctype="application/x-www-form-urlencoded"
		action="resources" method="get">
			<select name="c1">
			<option value="o1">o1</option>
			<option value="o2">o2</option>
			</select>
			<br>
			<input name="request" type="submit" value="Submit"></input>
		</form>
	</body>
</html>

AmlOrderedList

Description

An AmlOrderedList is a standard Ordered List. An AmlOrderedList has at least one AmlListItem. In the default type, the initial item is numbered 1. Additional AmlListItems will be numbered 2, 3, etc. Each AmlListItem has an AmlText object representing one item on the list.

Element Body

((AmlContainer*, AmlText?, AmlListItem+, AmlStyle?)

Parent

AmlPage, AmlForm, AmlTableCol, AmlGroup

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
type	Set type	(numeric\|uppercase_roman\|lowercase_roman\|lowercase_alpha\|uppercase_alpha	numeric	No
indent	Set indentation string	CDATA	No Default	No
start	Set start attribute	CDATA	No Default	No
cache	Set caching	(true\|false)	true	No
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Welcome">
	<AmlPage title="Chooser" bold="true">
		<AmlOrderedList>
		<AmlListItem>
		<AmlText text="Running"/>
		</AmlListItem>
		<AmlListItem>
		<AmlText text="Jumping"/>
		</AmlListItem>
		<AmlListItem>
		<AmlText text="Skipping"/>
		</AmlListItem>
		</AmlOrderedList>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Chooser</p>
		<p>
		1. Running<br/>
		2. Jumping<br/>
		3. Skipping<br/>
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Chooser</b>
			</a>
		</div>
			<ol type="1">
			<li>Running</li>
			<li>Jumping</li><li>Skipping</li>
			</ol>
	</body>
</html>

AmlPage

Description

An AmlPage is a display page on the mobile device. An AmlPage is added to the AmlDocument. AmlPage is the primary container element.

Element Body

Parent

AmlDocument

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
id	Id for page	CDATA	No Default	No
title	Title for Page	CDATA	No Default	No
titlecolor	Color of title on page. Color name or number	Color name or number	No Default	No
textsize	Size of text on page	(big\|normal\|small)	normal	No
italics	Set title to italic	(true\|false)	false	No
bold	Set title to bold	(true\|false)	false	No
underline	Set title to underlined	(true\|false)	false	No
halign	Halign title on page.	(left\|right\|center)	center	No
font	Font of the title	CDATA	No Default	No
blink	Set title to blink	(true\|false)	false	No
marquee	Set title to marquee	(true\|false)	false	No
cache	Set caching for page	(true\|false)	true	No
summary	Set summary text for the page	CDATA	No Default	No
prev_label	Set previous label for page	CDATA	No Default	No
next_label	Set next label for page	CDATA	No Default	No
menu_pos	Set position for control menus on page	(top\|bottom\|topbottom)	true	No
cache_view	Set cache view for cache menus on page	(menu\|link)	menu	No
refresh	Set refresh URL for the page	CDATA	No Default	No
refresh_timeout	Set refresh timeout for document	number of seconds	No Default	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
		<AmlPage title="Hello World Page">
		<AmlText text="Hello World!"/>
		</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
		<card id="agp0">
		<p align="center">Hello World Page</p>
		<p>Hello World!</p>
		</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
		<body>
			<div align="center">
			<a name="agp0">
			Hello World Page
			</a>
			</div>
		Hello World!
		</body>
</html>

AmlParam

Description

An AmlParam element is used to specify a URL parameter for AmlURL

Element Body

Empty

Parent

AmlURL

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
name	Set the name of the parameter	CDATA	No Default	yes
value	Set the value of the parameter	CDATA	No Default	yes

Markup Language Examples

Sample AML Input:

<AmlDocument title="AmlURL ">
	<AmlPage menu_pos="bottom">
		<AmlLink>
			<AmlURL action="http://www.google.com/search">
				<AmlParam name="soda" value="true"/>
				<AmlParam name="flavour" value="orange"/>
				<AmlParam name="colour" value="orange"/>
			</AmlURL>
				<AmlText text="Hello World Link!"/>
		</AmlLink>
		<AmlBr/>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="nt">
		<p align="center">
		</p>
		<p>Hello world</p>
		<do label="Next Page" type="options">
			<go href="#agp1" sendreferer="true"/>
		</do>
	</card>
	<card id="agp1">
		<do label="Previous Page" type="options">
			<go href="#nt" sendreferer="true"/>
		</do>
		<onevent type="ontimer">
			<go href="http://www.yahoo.com"/>
		</onevent>
		<timer value="1"/>
		<p align="center"></p>
		<p>
			<a href="http://www.google.com/search?soda=true&amp;
			flavour=orange&amp;colour=orange"> Hello World Link!
			</a>
		</p>
		<p><br/></p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>AmlURL </title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="nt"></a>
		</div>Hello world
		<div align="center">
			<a name="agp1"></a>
		</div>
			<a href="http://www.google.com/search?soda=true&flavour=orange&colour=oran
			ge"> Hello World Link!</a>
			<br>
	</body>
</html>

AmlPCData

Description

This element has been deprecated. The AmlText element has replaced the AmlPCData element. The AmlPage element is used to place text on a display. The text exhibited is the value of the text attribute. The text can be adjusted as to horizontal alignment (align attribute). The text can be made italic, bold, or underlined.

Element Body

Empty

Parent

AmlPage, AmlForm

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
text	Set text displayed	CDATA	No Default	No
textsize	Set size of text	(big\|normal\|small)	normal	No
align	Set horizontal alignment	(left\|right\|center)	center	No
italics	Set italics emphasis	(true\|false)	false	No
bold	Set bold emphasis	(true\|false)	false	No
underline	Set underline emphasis	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage title="Hello World Page">
		<AmlPCData text="Hello World!"/>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0">
		<p align="center">Hello World Page</p>
		<p><br/>Hello World!</p> <p><br/></p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">Hello World Page</a>
		</div>
		<br>Hello World!<br>
	</body>
</html>

AmlSelectList

Description

An AmlSelectList contains AmlLink elements in AmlSelectListItems instead of AmlText elements in AmlListItems. AmlSelectLists are used to offer multiple options for transfers to URLs.

Element Body

(AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlPage

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
wml_select_label	Set select label	CDATA	ok	No
cache	Set caching	(true\|false)	true	No
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Welcome">
	<AmlPage title="Chooser" bold="true">
		<AmlSelectList>
		<AmlSelectListItem>
		<AmlLink url="Running" text="Running"/>
		</AmlSelectListItem>
		<AmlSelectListItem>
		<AmlLink url="Jumping" text="Jumping"/>
		</AmlSelectListItem>
		<AmlSelectListItem>
		<AmlLink url= "Skipping" text="Skipping"/>
		</AmlSelectListItem>
		</AmlSelectList>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Chooser</p>
		<p>
			<select>
			<option onpick="Running">Running</option>
			<option onpick="Jumping">Jumping</option>
			<option onpick="Skipping">Skipping</option>
			</select>
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Chooser</b>
			</a>
		</div>
			<a href="Running">Running</a><br>
			<a href="Jumping">Jumping</a><br>
			<a href="Skipping">Skipping</a><br>
	</body>
</html>

AmlSelectListItem

Description

An AmlSelectListItem is a standard list item. An AmlSelectListItem can be an item in an AmlSelectList. An AmlSelectListItem has no attributes.

Element Body

(((AmlContainer | AmlLink)*, AmlStyle?)

Parent

AmlSelectList

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
None	Not Applicable	Not Applicable	Not Applicable	Not Applicable

Markup Language Examples

Sample AML Input:

<AmlDocument bold="true" title="Welcome">
  <AmlPage title="Chooser" bold="true">
    	<AmlSelectList>
      		<AmlSelectListItem> 
				<AmlLink url="Running" text="Running"/> 
				</AmlSelectListItem> 
				<AmlSelectListItem>
        	<AmlLink url="Jumping" text="Jumping"/>
      		</AmlSelectListItem> 
				<AmlSelectListItem>
        	<AmlLink url= "Skipping" text="Skipping"/> 
				</AmlSelectListItem>
		</AmlSelectList>
  </AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Chooser</p>
		<p>
		<select>
			<option onpick="Running">Running</option>
			<option onpick="Jumping">Jumping</option>
			<option onpick="Skipping">Skipping</option>
		</select>
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Chooser</b>
			</a>
		</div>
			<a href="Running">Running</a><br>
			<a href="Jumping">Jumping</a><br>
			<a href="Skipping">Skipping</a><br>
	</body>
</html>

AmlSpace

Description

An AmlSpace is a standard text element for inserting spaces. AmlSpace can be added to an AmlForm or AmlPage.

Element Body

( (AmlContainer)*, AmlStyle? )

Parent

AmlPage, AmlForm, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
size	Set size of text	CDATA	1	No
cache	Turn caching on/off	(true\|false)	true	No
persist	Set the value of the persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage>
		<AmlText text="Hello World"/>
		<AmlSpace size="3"/>
		<AmlText text="End of Message."/>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center"></p>
		<p>Hello World&nbsp;&nbsp;&nbsp;End of Message.
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0"></a>
		</div>
		Hello World&nbsp;&nbsp;&nbsp;End of Message.
	</body>
</html>

AmlStyle

Description

An AmlStyle object is used to change the way another AML element is rendered. A style will be applied when a condition you specify (a protocol or device) is present. Styles can have a wide range of effects on elements in their scope. AmlStyle elements can have a StyleId, be stored in libraries, and invoked by the developer. They may also be Inline and defined when used.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlDocument, AmlPage, AmlChoice, AmlOption, AmlForm, AmlTable, AmlTableRow, AmlTableCol, AmlInput, AmlLink, AmlControlMenu, AmlCheckBox, AmlText, AmlImage, AmlGroup, AmlListItem, AmlSelectListItem, AmlOrderedList, AmlList, AmlSelectList, AmlSpace

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
dpo	Set dpo	CDATA	No Default	No
protocol	Set protocol	CDATA	No Default	No
device	Set device type.	CDATA	No Default	No
styleid	Set styleid in style library	CDATA	No Default	No
inlinestyle	Set inlinestyle	CDATA	No Default	No

Markup Language Examples

The AML input example that follows happens to use cHTML as the protocol. Therefore, the use of the AmlStyle element in this example affects the cHTML output but not the WML output as demonstrated in the output examples.

For information about all the supported protocols and the corresponding devices, access the Client Manager page using the Identity Server administration console.

Note –

To Access the Client Manager

Log in to the Access Manager administration console as the administrator.

By default, Identity Management is selected in the Header frame (the top horizontal frame).
Click the Service Configuration tab.

A list of services appears in the Navigation frame (the left vertical frame).
Scroll down the Navigation frame and click the arrow for Client Detection.

The Client Detection page appears in the Data frame (the right vertical frame).

Click the Edit link.

The Client Manager window appears. From this window you can select a markup language to view a list of supported devices.

Sample AML Input:

<AmlDocument title="Style Test">
	<AmlPage title="Using Styles">
		<AmlForm url="Next">
			<AmlInput name="user">
				<AmlText text="Username"/>
				<AmlStyle protocol="CHtml" inlinestyle=’&lt;
				Input type="timepicker" name=".:name" size=".:width" /&gt;’/>
			</AmlInput>
		</AmlForm>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0">
		<p align="center">Using Styles</p>
		<p>Username<input emptyok="true" name="user"/></p>
		<do label="submit" type="accept"><go href="Next?user=$(user)"
		sendreferer="true" method="get"/></do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Style Test</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">Using Styles</a>
		</div>
		<form enctype="application/x-www-form-urlencoded"
		action="Next" method="get">
			<input name="user" type="timepicker"></input>
			Username<br>
			<input name="request" type="submit" value="Submit"></input>
		</form>
	</body>
</html>

AmlTable

Description

The AmlTable is a standard table element. AmlTable is the table as a whole and is not a content presenter. The AmlTable must contain one or more AmlTableRows. An AmlTableRow must contain one or more AmlTableCols. An AmlTable can be added to an AmlPage or an AmlForm.

Element Body

(AmlContainer*, AmlTableRow+, AmlStyle?)

Parent

AmlPage, AmlForm, AmlGroup

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
columns	Set number of columns for table	CDATA	No Default	No
maxcolwidth	Set maximum column width for columns in table	CDATA	No Default	No
border	Set border width for table	CDATA	No Default	No
halign	Set horizontal alignment	(left\|right\|center)	No Default	No
cache	Set cache flag	(true\|false)	true	No
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Welcome">
	<AmlPage title="Table" bold="true">
		<AmlTable columns="3"><AmlTableRow header="true">
		<AmlTableCol><AmlText text="Name"/>
		</AmlTableCol><AmlTableCol>
		AmlText text="Location"/></AmlTableCol>
		<AmlTableCol><AmlText text="State"/>
		</AmlTableCol></AmlTableRow>
		<AmlTableRow><AmlTableCol>
		<AmlText text="Dev"/></AmlTableCol>
		<AmlTableCol><AmlText text="Phoenix"/>
		</AmlTableCol><AmlTableCol>
		<AmlText text="AZ"/></AmlTableCol>
		</AmlTableRow><AmlTableRow>
		<AmlTableCol><AmlText text="Mktg"/>
		</AmlTableCol><AmlTableCol>
		<AmlText text="SFO"/></AmlTableCol>
		<AmlTableCol><AmlText text="CA"/>
		</AmlTableCol></AmlTableRow>
		</AmlTable>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
		<card id="agp0"> 
		<p align="center">Table</p>
		<p>
		<select>
		<option onpick="#agp0r1">Dev</option>
		<option onpick="#agp0r2">Mktg</option>
		</select>
		</p>
		</card>
		<card id="agp0r1">
		<p>Name : Dev<br/>Location : Phoenix<br/>State :AZ<br/>
		<a href="#agp0">Back</a>
		</p>
		</card>
		<card id="agp0r2">
		<p>Name : Mktg<br/>Location : SFO<br/>State : CA<br/>
		<a href="#agp0">Back</a>
		</p>
		</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Table</b>
			</a>
		</div>
		<table> <tr> <td>Name</td>
		<td>Location</td> <td>State</td>
		</tr> <tr> <td>Dev</td>
		<td>Phoenix</td> <td>AZ</td>
		</tr> <tr> <td>Mktg</td>
		<td>SFO</td> <td>CA</td>
		</tr> </table>
	</body>
</html>

AmlTableCol

Description

An AmlTableCol can contain most content elements. An AmlTableRow begins with one AmlTableCol.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
maxcolwidth	Set maxcolwidth for table column	CDATA	No Default	No
priority	Set priority on table column	CDATA	No Default	No
halign	Set horizontal alignment for table column	(left\|right\|center)	No Default	No
valign	Set vertical alignment for table column	(top\|middle\|bottom)	No Default	No
bgcolor	Set background color of table column	Color name or numeric value	No Default	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Set underline for table column text	(true\|false)	false	No
text	Set text	CDATA	No Default	No
textsize	Set size of text for table column	(big\|normal\|small)	normal	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Welcome">
	<AmlPage title="Table" bold="true">
		<AmlTable columns="3">
		<AmlTableRow header="true">
		<AmlTableCol> <AmlText text="Name"/>
		</AmlTableCol> <AmlTableCol>
		<AmlText text="Location"/> </AmlTableCol>
		<AmlTableCol> <AmlText text="State"/>
		</AmlTableCol>
		</AmlTableRow>
		<AmlTableRow>
		<AmlTableCol> <AmlText text="Dev"/>
		</AmlTableCol> <AmlTableCol>
		<AmlText text="Phoenix"/> </AmlTableCol>
		<AmlTableCol> <AmlText text="AZ"/>
		</AmlTableCol>
		</AmlTableRow>
		<AmlTableRow>
		<AmlTableCol> <AmlText text="Mktg"/>
		</AmlTableCol> <AmlTableCol>
		<AmlText text="SFO"/></AmlTableCol>
		<AmlTableCol> <AmlText text="CA"/>
		</AmlTableCol>
		</AmlTableRow>
		</AmlTable>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
		<card id="agp0">
			<p align="center">Table</p>
			<p>
				<select>
					<option onpick="#agp0r1">Dev</option>
					<option onpick="#agp0r2">Mktg</option>
				</select>
			</p>
		</card>
		<card id="agp0r1">
			<p>Name : Dev<br/>Location : Phoenix<br/>State : AZ<br/>
				<a href="#agp0">Back</a>
			</p>
		</card>
		<card id="agp0r2">
			<p>Name : Mktg<br/>Location : SFO<br/>State : CA<br/>
				<a href="#agp0">Back</a>
			</p>
		</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Table</b>
			</a>
		</div>
		<table>
			<tr>
				<td>Name</td> <td>Location</td>
				<td>State</td> </tr>
			<tr>
				<td>Dev</td> <td>Phoenix</td>
				<td>AZ</td> </tr>
			<tr>
				<td>Mktg</td> <td>SFO</td>
				<td>CA</td> </tr>
		</table>
	</body>
</html>

AmlTableHead

Description

This element has been deprecated. The AmlTableHead is a table column containing text only that appears at the top of a column. The row will appear on each of the pages where AmlTableCol elements are shown.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlTableRow

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
maxcolwidth	Deprecated	CDATA	No Default	No
priority	Deprecated	CDATA	No Default	No
halign	Deprecated	(left\|right\|center)	No Default	No
valign	Deprecated	(top\|middle\|bottom)	No Default	No
bgcolor	Deprecated	(true\|false)	false	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Deprecated	(true\|false)	false	No
text	Deprecated	CDATA	No Default	No
textsize	Deprecated	(big\|normal\|small)	normal	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Welcome">
	<AmlPage title="Table" bold="true">
		<AmlTable columns="3">
			<AmlTableRow>
				<AmlTableHead> <AmlText text="Name"/>
				</AmlTableHead> <AmlTableHead>
				<AmlText text="Location"/> </AmlTableHead>
				<AmlTableHead> <AmlText text="State"/>
				</AmlTableHead>
			</AmlTableRow>
			<AmlTableRow>
		<AmlTableCol>
				<AmlText text="Dev"/>
		</AmlTableCol>
		<AmlTableCol>
				<AmlText text="Phoenix"/>
		</AmlTableCol>
		<AmlTableCol>
				<AmlText text="AZ"/>
		</AmlTableCol>
			</AmlTableRow>
			<AmlTableRow>
		<AmlTableCol>
				<AmlText text="Mktg"/>
		</AmlTableCol>
		<AmlTableCol>
				<AmlText text="SFO"/>
		</AmlTableCol>
		<AmlTableCol>
				<AmlText text="CA"/>
		</AmlTableCol>
			</AmlTableRow>
		</AmlTable>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
	<card id="agp0">
		<p align="center">Table</p>
		<p>
			<select>
				<option onpick="#agp0r1">Dev</option>
				<option onpick="#agp0r2">Mktg</option>
			</select>
		</p>
	</card>
	<card id="agp0r1">
				<p>Name : Dev<br/>Location : Phoenix<br/>State : AZ<br/>
				<a href="#agp0">Back</a> </p>
	</card>
	<card id="agp0r2">
		<p>Name : Mktg<br/>Location : SFO<br/>State : CA<br/>
			<a href="#agp0">Back</a>
		</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Table</b>
			</a>
		</div>
		<table>
			<tr>
				<td>Name</td> <td>Location</td>
				<td>State</td> </tr>
			<tr>
				<td>Dev</td>
				<td>Phoenix</td>
				<td>AZ</td>
			</tr>
			<tr>
				<td>Mktg</td>
				<td>SFO</td>
				<td>CA</td>
			</tr>
		</table>
	</body>
</html>

AmlTableRow

Description

An AmlTableRow element is not a content containing element. AmlTableRow contains one or more AmlTableHead or AmlTableCol elements. If the header attribute is true, the row will appear on each of the pages where AmlTableCol elements are shown.

Element Body

(AmlContainer*, (AmlTableHead | AmlTableCol)+, AmlStyle?, AmlOrderedLayout?, AmlOrderedConstraints?)

Parent

AmlTable

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
header	Set header option for row	(true\|false)	false	No
persist	Set persist flag on row	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="Welcome">
	<AmlPage title="Table" bold="true">
		<AmlTable columns="3">
			<AmlTableRow header="true"> <AmlTableCol>
			<AmlText text="Name"/> </AmlTableCol>
			<AmlTableCol> <AmlText text="Location"/>
			</AmlTableCol> <AmlTableCol>
			<AmlText text="State"/> </AmlTableCol>
			</AmlTableRow> <AmlTableRow>
			<AmlTableCol> <AmlText text="Dev"/>
			</AmlTableCol> <AmlTableCol>
			<AmlText text="Phoenix"/> </AmlTableCol>
			<AmlTableCol> <AmlText text="AZ"/>
			</AmlTableCol> </AmlTableRow>
			<AmlTableRow> <AmlTableCol>
			<AmlText text="Mktg"/> </AmlTableCol>
			<AmlTableCol> <AmlText text="SFO"/>
			</AmlTableCol> <AmlTableCol>
			<AmlText text="CA"/> </AmlTableCol>
			</AmlTableRow>
		</AmlTable>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head><meta http-equiv="Cache-Control" content="max-age=0"/></head>
		<card id="agp0">
		<p align="center">Table</p>
		<p> <select>
		<option onpick="#agp0r1">Dev</option>
		<option onpick="#agp0r2">Mktg</option>
		</select> </p>
		</card>  <card id="agp0r1">
		<p>Name : Dev<br/>Location : Phoenix<br/>State : AZ<br/>
		<a href="#agp0">Back</a> </p>
		</card> <card id="agp0r2">
		<p>Name : Mktg<br/>Location : SFO<br/>State : CA<br/>
		<a href="#agp0">Back</a> </p>
		</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>Welcome</title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0">
				<b>Table</b>
			</a>
		</div>
		<table>
			<tr> <td>Name</td>
			<td>Location</td> <td>State</td>
			</tr> <tr>
			<td>Dev</td> <td>Phoenix</td>
			<td>AZ</td> </tr>
			<tr> <td>Mktg</td>
			<td>SFO</td><td>CA</td>
			</tr>
		</table>
	</body>
</html>

AmlText

Description

An AmlText is the element for placing text on a display. The text exhibited is the value of the text attribute. The text can be adjusted as to font size (textsize attribute), and horizontal alignment (halign attribute). The text can be made italic, bold, or underline.

Element Body

((AmlContainer*, AmlStyle?)

Parent

AmlPage, AmlChoice, AmlOption, AmlForm, AmlTableCol, AmlTableHead, AmlInput, AmlLink, AmlControlMenu, AmlCheckBox, AmlGroup, AmlListItem, AmlOrderedList, AmlList, AmlSelectList

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
text	Set text displayed	CDATA	No Default	No
textsize	Set size of text	(big\|normal\|small)	normal	No
halign	Set horizontal alignment	(left\|right\|center)	center	No
valign	Set vertical alignment	(top\|middle\|bottom)	normal	No
font	Set font	CDATA	No Default	No
italics	Set italics emphasis	(true\|false)	false	No
bold	Set bold emphasis	(true\|false)	false	No
underline	Set underline emphasis	(true\|false)	false	No
color	Set color	CDATA	No Default	No
blink	Set the text to blink	(true\|false)	false	No
marquee	Set the title to marquee	(true\|false)	false	No
cache	Set caching	(true\|false)	false	No
persist	Set the persist flag	(true\|false)	false	No
encode	Set the encode flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<AmlDocument>
	<AmlPage title="Hello World Page">
		<AmlText text="Hello World!"/>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center">Hello World Page</p> <p>Hello World!</p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
		<a name="agp0">Hello World Page</a>
		</div>
		Hello World!
	</body>
</html>

AmlTextArea

Description

An AmlTextArea offers a larger text input area than an AmlText. This element is used for descriptions. The AmlTextArea has an AmlText for its label. The value of the name attribute is the variable where entered content is available. AmlTextArea can be added to an AmlForm.

Element Body

((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)

Parent

AmlForm, AmlTableCol, AmlGroup, AmlListItem

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
name	Set variable name content	CDATA	No Default	Yes
value	Set value for `text area`	CDATA	No Default	No
view	Set view option	(show\|hidden\|none)	show	No
height	Set height of text area	CDATA	No Default	No
width	Set width of text area	CDATA	No Default	No
format	Set format	CDATA	No Default	No
maxchars	Set maxchars of text area	CDATA	No Default	No
italics	Deprecated	(true\|false)	false	No
bold	Deprecated	(true\|false)	false	No
underline	Set underline text	(true\|false)	false	No
text	Deprecated	CDATA	No Default	No
textsize	Deprecated	(big\|normal\|small)	normal
persist	Set persist flag	(true\|false)	false	No

Markup Language Examples

Sample AML Input:

<?xml version="1.0" encoding="ISO-8859-6"?>
	<AmlDocument>
		<AmlPage>
			<AmlForm url="http://watchita">
				<AmlTextArea name="desc" >
				<AmlText text="Description"/> </AmlTextArea>
			</AmlForm>
		</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="agp0">
		<p align="center"></p>
		<p> Description
		<input emptyok="true" name="desc"/>
		</p>
		<do label="submit" type="accept">
			<go href="http://watchita?desc=$(desc)" sendreferer="true" method="get"/>
		</do>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title></title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="agp0"></a>
		</div>
		<form enctype="application/x-www-form-urlencoded"
		action="http://watchita" method="get">
		Description
		<textarea name="desc"></textarea><br>
		<input name="request" type="submit" value="Submit"></input>
		</form>
	</body>
</html>

AmlURL

Description

An AmlURL element creates a URL in the document.

Element Body

(AmlParam)*

Parent

Restrictions

None

AML Attributes

Attribute	Description	Possible values	Default	Req’d?
action	Set the base location of the URL	CDATA	No Default	No
type	Set the attribute in which the URL is contained	wml_refresh	No Default	No
cache	Set caching	(true\|false)	true	No
persist	Set the persist flag	(true\|false)	true	No
encode	Set the encode flag	(true\|false)	true	No

Markup Language Examples

Sample AML Input:

<AmlDocument title="AmlURL ">
	<AmlPage menu_pos="bottom">
		<AmlLink> <AmlURL action="http://www.google.com/search">
		<AmlParam name="soda" value="true"/>
		<AmlParam name="flavour" value="orange"/>
		<AmlParam name="colour"  value="orange"/>
		</AmlURL>
		<AmlText text="Hello World Link!"/>
		</AmlLink>
		<AmlBr/>
	</AmlPage>
</AmlDocument>

Sample WML Output:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
	<head>
		<meta http-equiv="Cache-Control" content="max-age=0"/>
	</head>
	<card id="nt">
		<p align="center"></p>
		<p>Hello world</p>
		<do label="Next Page" type="options">
			<go href="#agp1" sendreferer="true"/>
		</do>
	</card>
	<card id="agp1">
		<do label="Previous Page" type="options">
			<go href="#nt" sendreferer="true"/>
		</do>
		<onevent type="ontimer">
			<go href="http://www.yahoo.com"/>
		</onevent>
		<timer value="1"/>
		<p align="center"></p>
		<p>
		<a href="http://www.google.com/search?soda=true&amp;flavour=orange&	
			amp;colour=orange"> HelloWorld Link! </a>
		</p>
		<p><br/></p>
	</card>
</wml>

Sample cHTML Output:

<html>
	<head>
		<title>AmlURL </title>
		<meta name="PalmComputingPlatform" content="true"></meta>
		<meta http-equiv="Pragma" content="no-cache"></meta>
		<meta http-equiv="Cache-Control" content="no-cache"></meta>
	</head>
	<body>
		<div align="center">
			<a name="nt"></a>
		</div>Hello world
		<div align="center">
			<a name="agp1"></a>
		</div>
			<a href="http://www.google.com/search?soda=true&flavour=orange&colo
				ur=orange">Hello World Link!</a><br>
	</body>
</html>