html
Tag form


Define An Input Form

Renders an HTML <form> element whose contents are described by the body content of this tag. The form implicitly interacts with the specified request scope or session scope bean to populate the input fields with the current property values from the bean.

The form bean is located, and created if necessary, based on the form bean specification for the associated ActionMapping.



Tag Information
Tag Classorg.apache.struts.taglib.html.FormTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
action

The URL to which this form will be submitted. This value is also used to select the ActionMapping we are assumed to be processing, from which we can identify the appropriate form bean and scope. If a value is not provided, the original URI (servletPath) for the request is used.

If you are using extension mapping for selecting the controller servlet, this value should be equal to the path attribute of the corresponding <action> element, optionally followed by the correct extension suffix.

If you are using path mapping to select the controller servlet, this value should be exactly equal to the path attribute of the corresponding <action> element.

 
Required: false
Request-time: false
Type: java.lang.String
acceptCharset
The list of character encodings for input data that the server should accept.
Since:
Struts 1.2.2
 
Required: false
Request-time: false
Type: java.lang.String
dir

The direction for weak/neutral text for this element.

Since:
Struts 1.3.6
 
Required: false
Request-time: false
Type: java.lang.String
disabled
Set to true if the Form's input fields should be disabled.
Since:
Struts 1.2.7
 
Required: false
Request-time: false
Type: java.lang.String
enctype
The content encoding to be used to submit this form, if the method is POST. This must be set to "multipart/form-data" if you are using the file tag to enable file upload. If not specified, the browser default (normally "application/x-www-form-urlencoded") is used.
 
Required: false
Request-time: false
Type: java.lang.String
focus
The field name (among the fields on this form) to which initial focus will be assigned with a JavaScript function. If not specified, no special JavaScript for this purpose will be rendered.
 
Required: false
Request-time: false
Type: java.lang.String
focusIndex
If the focus field is a field array, such as a radio button group, you can specify the index in the array to receive focus.
Since:
Struts 1.1
 
Required: false
Request-time: false
Type: java.lang.String
lang

The language code for this element.

Since:
Struts 1.3.6
 
Required: false
Request-time: false
Type: java.lang.String
method
The HTTP method that will be used to submit this request (GET, POST). [POST]
 
Required: false
Request-time: false
Type: java.lang.String
onreset
JavaScript event handler executed if the form is reset.
 
Required: false
Request-time: false
Type: java.lang.String
onsubmit
JavaScript event handler executed if the form is submitted.
 
Required: false
Request-time: false
Type: java.lang.String
readonly
Set to true if the Form's input fields should be read only.
Since:
Struts 1.2.7
 
Required: false
Request-time: false
Type: java.lang.String
scriptLanguage
The form's focus <script> element will not contain a language attribute when this is set to false. The default is true but this property is ignored in XHMTL mode.
Since:
Struts 1.2
 
Required: false
Request-time: false
Type: java.lang.String
style
CSS styles to be applied to this HTML element.
 
Required: false
Request-time: false
Type: java.lang.String
styleClass
CSS stylesheet class to be applied to this HTML element (renders a "class" attribute).
 
Required: false
Request-time: false
Type: java.lang.String
styleId
Identifier to be assigned to this HTML element (renders an "id" attribute).
 
Required: false
Request-time: false
Type: java.lang.String
target
Window target to which this form is submitted, such as for use in framed presentations.
 
Required: false
Request-time: false
Type: java.lang.String

Variables
No Variables Defined.


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.