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

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>