Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICE Components
Tag form

Renders an HTML "form" element.

Decode Behavior

Obtain the `Map` from the "requestParameterMap" property of the `ExternalContext`. If the map contains an entry for the "clientId" of this `UIForm` component, call `setSubmitted(true)` on the form, otherwise call `setSubmitted(false)` on the form.

Encode Behavior

The value of the "method" attribute must be "post". The value of the "action" attribute must be the result of passing the view identifier of the current view to the `getActionURL()` method of the `ViewHandler` for this application, then passing that String to the `encodeActionURL()` method on the `ExternalContext`. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute. Render all the necessary hidden fields for all commandLink instances in the page just before the close of the "form" element.

Tag Information
Tag Class | com.icesoft.faces.component.FormTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
accept | false | false | `java.lang.String` | List of content types that a server processing this form will handle correctly
acceptcharset | false | false | `java.lang.String` | List of character encodings for input data that are accepted by the server processing this form.
action | false | false | `java.lang.String` | MethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application.
actionListener | false | false | `java.lang.String` | MethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void. This listener will only be invoked if the target component itself doesn't handle the ActionEvent.
autocomplete | false | false | `java.lang.String` | Passed through to root element.
binding | false | false | `java.lang.String` | The value binding expression linking this component to a property in a backing bean
dir | false | false | `java.lang.String` | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
enctype | false | false | `java.lang.String` | Content type used to submit the form to the server. If not specified, the default value is "application/x-www-form-urlencoded".
id | false | false | `java.lang.String` | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
lang | false | false | `java.lang.String` | Code describing the language used in the generated markup for this component.
onclick | false | false | `java.lang.String` | No Description
ondblclick | false | false | `java.lang.String` | No Description
onkeydown | false | false | `java.lang.String` | No Description
onkeypress | false | false | `java.lang.String` | No Description
onkeyup | false | false | `java.lang.String` | No Description
onmousedown | false | false | `java.lang.String` | No Description
onmousemove | false | false | `java.lang.String` | No Description
onmouseout | false | false | `java.lang.String` | No Description
onmouseover | false | false | `java.lang.String` | No Description
onmouseup | false | false | `java.lang.String` | No Description
onreset | false | false | `java.lang.String` | Javascript code executed when this form is reset.
onsubmit | false | false | `java.lang.String` | Javascript code executed when this form is submitted.
partialSubmit | false | false | `java.lang.String` | Enable component to perform partial submit. Default value is false.
prependId | false | false | `java.lang.String` | Flag indicating whether or not this form should prepend its id to its descendent's id during the clientId generation process. If this flag is not set, the default value is true.
rendered | false | false | `java.lang.String` | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRole | false | false | `java.lang.String` | If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.
style | false | false | `java.lang.String` | CSS style(s) to be applied when this component is rendered.
styleClass | false | false | `java.lang.String` | Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. The default class would be rendered as iceFrm
submitted | false | false | `java.lang.String` | submitted
target | false | false | `java.lang.String` | Name of a frame where the response retrieved after this form submit is to be displayed.
title | false | false | `java.lang.String` | Advisory title information about markup elements generated for this component.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.