Sun Java System Portal Server Mobile Access 6 2005Q1 Developer's Reference |
Chapter 9
Abstract Markup Language (AML) ElementsThis 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.
AML Description DetailsAML 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)
AmlBrDescription 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
Attribute
Description
Possible values
Default
Req’d?
None
Not Applicable
Not Applicable
Not Applicable
Not Applicable
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>
AmlCheckBoxDescription 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
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="submit" value="Submit"></input>
</form>
</body>
</html>
AmlChoiceDescription 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
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>
AmlContainerDescription 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.
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
Attribute
Description
Possible values
Default
Req’d?
persist
Set persist flag.
(true|false)
false
No
text
Set text in container
No
Sample AML Input:
<AmlDocument title="Welcome">
<AmlPage title="Script">
<AmlContainer text="<br/>"/>
</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>
AmlControlMenuDescription 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
Sample AML Input:
<?xml version="1.0" encoding="ISO-8859-6"?>
<AmlDocument>
<AmlPage>
<AmlControlMenu url="http://watchita" label="hehe" key="accept"/>
<AmlText text="Moonwatchers 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>
AmlDocumentDescription 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?)
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)&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>
AmlFormDescription 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 (( AmlContainer | AmlGroup | AmlInput | AmlChoice | AmlTextArea | AmlCheckBox | AmlTable | AmlLink | AmlImage | AmlText | AmlBr | AmlList | AmlOrderedList | AmlPCData | AmlSpace )*, AmlStyle?
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&b=x&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>
AmlGroupDescription 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 (( ( AmlContainer | AmlChoice | AmlForm | AmlLink | AmlTable | AmlText | AmlBr | AmlImage | AmlInput | AmlTextArea | AmlCheckBox | AmlList | AmlOrderedList | AmlSpace )*, AmlStyle? )
Parent AmlPage, AmlForm, AmlTableCol
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>
AmlImageDescription 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
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)&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>
AmlInputDescription 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
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)&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>
AmlLinkDescription 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
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>
AmlListDescription An AmlList is a standard bulleted List.
Element Body (AmlContainer*, AmlText?, AmlListItem+, AmlStyle?)
Parent AmlPage, AmlForm, AmlTableCol, AmlGroup
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>
AmlListItemDescription 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 (( (AmlContainer | AmlBr | AmlText | AmlImage | AmlLink | AmlInput | AmlTextArea | AmlCheckBox | AmlSpace )*, AmlStyle? )
Attribute
Description
Possible values
Default
Req’d?
None
Not Applicable
Not Applicable
Not Applicable
Not Applicable
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>
AmlOptionDescription 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? )
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>
AmlOrderedListDescription 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
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>
AmlPageDescription 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 (( ( AmlContainer | AmlChoice | AmlGroup | AmlForm | AmlLink | AmlTable | AmlControlMenu | AmlText | AmlBr | AmlImage | AmlList | AmlSelectList | AmlOrderedList | AmlPCData | AmlSpace )*, AmlStyle? )
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>
AmlParamDescription An AmlParam element is used to specify a URL parameter for AmlURL
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
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&flavour=orange&c olour=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=or ange"> Hello World Link!</a>
<br>
</body>
</html>
AmlPCDataDescription 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.
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>
AmlSelectListDescription 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?)
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
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>
AmlSelectListItemDescription 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?)
Attribute
Description
Possible values
Default
Req’d?
None
Not Applicable
Not Applicable
Not Applicable
Not Applicable
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>
AmlSpaceDescription 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
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
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 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 End of Message.
</body>
</html>
AmlStyleDescription 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
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.
Sample AML Input:
<AmlDocument title="Style Test">
<AmlPage title="Using Styles">
<AmlForm url="Next">
<AmlInput name="user">
<AmlText text="Username"/>
<AmlStyle protocol="CHtml" inlinestyle=’<Input type="timepicker" name=".:name" size=".:width" />’/>
</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>
AmlTableDescription 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
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>
AmlTableColDescription An AmlTableCol can contain most content elements. An AmlTableRow begins with one AmlTableCol.
Element Body ((AmlContainer*, (AmlText | AmlImage)?, AmlStyle?)
Parent AmlForm, AmlTableCol, AmlGroup, AmlListItem
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>
AmlTableHeadDescription 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?)
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>
AmlTableRowDescription 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?)
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
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>
AmlTextDescription 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
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>
AmlTextAreaDescription 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
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>
AmlURLDescription An AmlURL element creates a URL in the document.
Parent AmlPage, AmlChoice, AmlOption, AmlForm, AmlTableCol, AmlTableHead, AmlInput, AmlLink, AmlControlMenu, AmlCheckBox, AmlGroup, AmlListItem, AmlOrderedList, AmlList, AmlSelectList
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&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&colo ur=orange">Hello World Link!</a>
<br>
</body>
</html>