<sas:IForm>

This tag is used for creating an IForm for use with a variety of markup languages (including WML,HDML, and HTML). The IForm is used to collect user input from a variety of devices.The user can use this class to write an IForm without having to know the markup language that is to reference the page.

Syntax

<sas:IForm
   [action="java.lang.String"]
   [actionLabel="java.lang.String"]
   [cacheTimeToLive="int"]
   [customAttributes="java.lang.String"]
   [epilog="java.lang.String"]
   [id="value"]
   [instantiate="true|false"]
   [locale="java.util.Locale"]
   [method="java.lang.String"]
   [name="java.lang.String"]
   [objectDataProperty="java.lang.String"]
   [prolog="java.lang.String"]
   [ref="java.lang.String"]
   [render="true|false"]
   [scope="page|request|session|application"]
   [title="java.lang.String"]>
      [<sas:IFormTextEntry ...>
         [<sas:IOption .../>]
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas:IOption>, <sas:SetProperty> tags...]
      </sas:IFormTextEntry>]
      [<sas:IFormPassword ...>
         [<sas:IOption .../>]
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas:IOption>, <sas:SetProperty> tags...]
      </sas:IFormPassword>]
      [<sas:IFormHidden .../>]
      [<sas:IFormListBox ...>
         [<sas:IOption .../>]
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas:IOption>, <sas:SetProperty> tags...]
         [One or more lines of choices to be used in the listbox]
      </sas:IFormListBox>]
      [<sas:IFormRadio ...>
         [<sas:IOption .../>]
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas:IOption>, <sas:SetProperty> tags...]
         [One or more lines of choices to be used in the RadioTag]
      </sas:IFormRadio>]
      [<sas:IOption .../>]
      [<sas:SetProperty ...>
         The value to set on the parent tag
      </sas:SetProperty>]
      [Additional <sas:IFormTextEntry>, <sas:IFormPassword>, <sas:IFormHidden>, <sas:IFormListBox>, <sas:IFormRadio>, <sas:IOption>, <sas:SetProperty> tags...]
</sas:IForm>

Example

<%@taglib uri="http://www.sas.com/taglib/sas" prefix="sas"%>

<sas:IForm name="form" action="results.jsp" title="IForm Ex">
 <sas:IFormTextEntry name="name" prompt="Please enter your username: "/>
 <sas:IFormPassword name="password" prompt="Enter your password: "/>
 <sas:IFormListBox name="hobbies" prompt="Favorite hobbies: " >
  Running
  Sleeping
  Reading
 </sas:IFormListBox>
 <sas:IFormRadio name="colors" prompt="Favorite color: ">
  Red
  Green
  Blue
  Yellow
 </sas:IFormRadio>
 <sas:IFormHidden name="foo" value="bar" />
</sas:IForm>


Attributes

action	The action URL to post forms, such as "http://www.sas.com/jsp/my.jsp".
actionLabel	The action URL to post forms, such as "http://www.sas.com/jsp/my.jsp".
cacheTimeToLive	The cacheTimeToLive in seconds of the bean.
customAttributes	a list of attributes in the form of attribute="value", space delimited
epilog	Text that is output immediately after the last markup tag.
id	Case-sensitive name used to identify the object instance.
instantiate	Flag that, if true, indicates that a new instance of the underlying class should be loaded if one cannot be found in PageContext. Must be used with an id attribute.
locale	Specifies the locale to use for this instance of the class.
method	The HTTP method. Valid values are "get"(default) or "post".
name	Value assigned to the markup tag's name attribute.
objectDataProperty	Value assigned to the output tag's objectDataProperty attribute.
prolog	Text that is output immediately preceeding the first markup tag.
ref	The variable String value that represents an object created earlier in the same scope.
render	Flag that, if true, indicates that the complete markup of the bean is output when the tag is closed. It also sets the the visible property on the underlying TransformationBean.
scope	The scope (or page context) within which the reference is available.
title	The title of the bean.

More Information

To view the documentation for the related TransformationBean, see com.sas.servlet.tbeans.ipage.iform.IForm.

If you need to subclass the tag handler class for the sas:IForm tag, extend com.sas.taglib.servlet.tbeans.ipage.IFormTag.