Page Construction Tags
This taglib contains tags used to create struts input forms, as well as other tags generally useful in the creation of HTML-based user interfaces.
Many of the tags in this tag library will throw a JspException
at runtime when they are utilized incorrectly (such as when you specify an invalid combination of tag attributes). JSP allows you to declare an "error page" in the <%@ page %>
directive. If you wish to process the actual exception that caused the problem, it is passed to the error page as a request attribute under key org.apache.struts.action.EXCEPTION
.
Tag Name | Description |
---|---|
base | Render an HTML <base> Element |
button | Render A Button Input Field |
cancel | Render a Cancel Button |
checkbox | Render A Checkbox Input Field |
errors | Conditionally display a set of accumulated error messages. |
file | Render A File Select Input Field |
form | Define An Input Form |
frame | Render an HTML frame element |
hidden | Render A Hidden Field |
html | Render an HTML <html> Element |
image | Render an input tag of type "image" |
img | Render an HTML img tag |
javascript | Render JavaScript validation based on the validation rules loaded by the ValidatorPlugIn. |
link | Render an HTML anchor or hyperlink |
messages | Conditionally display a set of accumulated messages. |
multibox | Render A Checkbox Input Field |
option | Render A Select Option |
options | Render a Collection of Select Options |
optionsCollection | Render a Collection of Select Options |
password | Render A Password Input Field |
radio | Render A Radio Button Input Field |
reset | Render A Reset Button Input Field |
rewrite | Render an URI |
select | Render A Select Element |
submit | Render A Submit Button |
text | Render An Input Field of Type text |
textarea | Render A Textarea |
xhtml | Render HTML tags as XHTML |
base - Render an HTML <base> Element
Renders an HTML <base>
element with an href
attribute pointing to the absolute location of the enclosing JSP page. This tag is valid only when nested inside an HTML <head>
element.
This tag is useful because it allows you to use relative URL references in the page that are calculated based on the URL of the page itself, rather than the URL to which the most recent submit took place (which is where the browser would normally resolve relative references against).
Attribute Name | Description |
---|---|
target | The window target for this base reference. [RT Expr] |
server | The server name to use instead of request.getServerName(). [RT Expr] |
button - Render A Button Input Field
Renders an HTML <input> element of type button
, populated from the specified value or the content of this tag body. This tag is only valid when nested inside a form tag body.
If a graphical button is needed (a button with an image), then the image
tag is more appropriate.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "propertyName[34]". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value of the label to be placed on this button. This value will also be submitted as the value of the specified request parameter. [Body of this tag (if any), or "Click"] [RT Expr] |
cancel - Render a Cancel Button
Renders an HTML <input> element of type submit. This tag is only valid when nested inside a form tag body. Pressing of this submit button causes the action servlet to bypass calling the associated form bean validate() method. The action is called normally.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. WARNING - If you set this attribute to a value other than the default, this will NOT be recognized as the cancel key by the Struts controller servlet or the Action.isCancelled() method. You will need to do your own cancel detection. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value of the label to be placed on this button. This value will also be submitted as the value of the specified request parameter. [Body of this tag (if any), or "Cancel"] [RT Expr] |
checkbox - Render A Checkbox Input Field
Renders an HTML <input> element of type checkbox
, populated from the specified value or the specified property of the bean associated with our current form. This tag is only valid when nested inside a form tag body.
NOTE: The underlying property value associated with this field should be of type boolean
, and any value
you specify should correspond to one of the Strings that indicate a true value ("true", "yes", or "on"). If you wish to utilize a set of related String values, consider using the multibox
tag.
WARNING: In order to correctly recognize unchecked checkboxes, the ActionForm
bean associated with this form must include a statement setting the corresponding boolean property to false
in the reset()
method.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | The value to be transmitted if this checkbox is checked when the form is submitted. If not specified, the value "on" will be returned. [RT Expr] |
errors - Conditionally display a set of accumulated error messages.
Displays a set of error messages prepared by a business logic component and stored as an ActionErrors
object, a String, or a String array in request scope. If such a bean is not found, nothing will be rendered.
In order to use this tag successfully, you must have defined an application scope MessageResources
bean under the default attribute name, with optional definitions of the following message keys:
- errors.header - Text that will be rendered before the error messages list. Typically, this message text will end with
<ul>
to start the error messages list. - errors.footer - Text that will be rendered after the error messages list. Typically, this message text will begin with
</ul>
to end the error messages list. - errors.prefix - Text that will be rendered before each individual error in the list.
- errors.suffix - Text that will be rendered after each individual error in the list.
Attribute Name | Description |
---|---|
bundle | The servlet context attribute key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet. [RT Expr] |
locale | The session attribute key for the Locale used to select messages to be displayed. If not specified, defaults to the Struts standard value. [RT Expr] |
name | Name of the request scope bean under which our error messages have been stored. If not present, the name specified by the Globals.ERROR_KEY constant string will be used. [RT Expr] |
property | Name of the property for which error messages should be displayed. If not specified, all error messages (regardless of property) are displayed. [RT Expr] |
file - Render A File Select Input Field
Renders an HTML <input> element of type file, defaulting to the specified value or the specified property of the bean associated with our current form. This tag is only valid when nested inside a form tag body.
As with the corresponding HTML <input> element, the enclosing form element must specify "POST" for the method
attribute, and "multipart/form-data" for the enctype
attribute. For example:
<html:form method="POST" enctype="multipart/form-data"> <html:file property="theFile" /> </html:form>
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
accept | Comma-delimited set of content types that the server you submit to knows how to process. This list can be used by the client browser to limit the set of file options that is made available for selection. If not specified, no content type list will be sent. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
maxlength | Maximum number of input characters to accept. This is ignored by most browsers. [No limit] [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr] |
size | Size of the file selection box to be displayed. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | NOTE: When setting this to some value, whether intentional or as the result (for example) of validation errors forcing the user back to the original jsp, this value is ignored by most browsers (for security reasons). This means that your users will have to re-select any previously selected files when submitting the form. Opera web browser will prompt the user so they have a chance to abort the submit. Value to which this field should be initialized. [Use the corresponding bean property value or body content (if any) if property is not specified] [RT Expr] |
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
.
Attribute Name | Description |
---|---|
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 you are using extension mapping for selecting the controller servlet, this value should be equal to the If you are using path mapping to select the controller servlet, this value should be exactly equal to the |
acceptCharset | The list of character encodings for input data that the server should accept. Since: Struts 1.2.2 [RT Expr] |
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. [RT Expr] |
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. [RT Expr] |
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 [RT Expr] |
method | The HTTP method that will be used to submit this request (GET, POST). [POST] [RT Expr] |
onreset | JavaScript event handler executed if the form is reset. [RT Expr] |
onsubmit | JavaScript event handler executed if the form is submitted. [RT Expr] |
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 [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
target | Window target to which this form is submitted, such as for use in framed presentations. [RT Expr] |
frame - Render an HTML frame element
Renders an HTML <frame>
element with processing for the src
attribute that is identical to that performed by the <html:link>
tag for the href
attribute. URL rewriting will be applied automatically, to maintain session state in the absence of cookies.
The base URL for this frame is calculated based on which of the following attributes you specify (you must specify exactly one of them):
- forward - Use the value of this attribute as the name of a global
ActionForward
to be looked up, and use the module-relative or context-relative URI found there. - href - Use the value of this attribute unchanged.
- page - Use the value of this attribute as a module-relative URI, and generate a server-relative URI by including the context path and application prefix.
- action - Use the value of this attribute as the logical name of a global Action that contains the actual content-relative URI of the destination of this transfer.
Normally, the hyperlink you specify with one of the attributes described in the previous paragraph will be left unchanged (other than URL rewriting if necessary). However, there are two ways you can append one or more dynamically defined query parameters to the hyperlink -- specify a single parameter with the paramId
attribute (and its associated attributes to select the value), or specify the name
(and optional property
) attributes to select a java.util.Map
bean that contains one or more parameter ids and corresponding values.
To specify a single parameter, use the paramId
attribute to define the name of the request parameter to be submitted. To specify the corresponding value, use one of the following approaches:
- Specify only the
paramName
attribute - The named JSP bean (optionally scoped by the value of theparamScope
attribute) must identify a value that can be converted to a String. - Specify both the
paramName
andparamProperty
attributes - The specified property getter method will be called on the JSP bean identified by theparamName
(and optionalparamScope
) attributes, in order to select a value that can be converted to a String.
If you prefer to specify a java.util.Map
that contains all of the request parameters to be added to the hyperlink, use one of the following techniques:
- Specify only the
name
attribute - The named JSP bean (optionally scoped by the value of thescope
attribute) must identify ajava.util.Map
containing the parameters. - Specify both
name
andproperty
attributes - The specified property getter method will be called on the bean identified by thename
(and optionalscope
) attributes, in order to return thejava.util.Map
containing the parameters.
As the Map
is processed, the keys are assumed to be the names of query parameters to be appended to the hyperlink. The value associated with each key must be either a String or a String array representing the parameter value(s), or an object whose toString() method will be called. If a String array is specified, more than one value for the same query parameter name will be created.
Additionally, you can request that the current transaction control token, if any, be included in the generated hyperlink by setting the transaction
attribute to true
. You can also request that an anchor ("#xxx") be added to the end of the URL that is created by any of the above mechanisms, by using the anchor
attribute.
Attribute Name | Description |
---|---|
action | Logical name of a global Additionally, you can specify a |
module | Prefix name of a Note: Use "" to map to the default module. [RT Expr] |
anchor | Optional anchor tag ("#xxx") to be added to the generated hyperlink. Specify this value without any "#" character. [RT Expr] |
forward | Logical name of a global |
frameborder | Should a frame border be generated around this frame (1) or not (0)? [RT Expr] |
frameName | Value for the |
href | The URL to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the |
longdesc | URI of a long description of the frame. This description should supplement the short description provided by the |
marginheight | The amount of space (in pixels) to be left between the frame's contents and its top and bottom margins. [RT Expr] |
marginwidth | The amount of space (in pixels) to be left between the frame's contents and its left and right margins. [RT Expr] |
name | The name of a JSP bean that contains a |
noresize | Should users be disallowed from resizing the frame? (true, false). [RT Expr] |
page | The module-relative path (beginning with a "/" character) to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the |
paramId | The name of the request parameter that will be dynamically added to the generated hyperlink. The corresponding value is defined by the |
paramName | The name of a JSP bean that is a String containing the value for the request parameter named by |
paramProperty | The name of a property of the bean specified by the |
paramScope | The scope within which to search for the bean specified by the |
property | The name of a property of the bean specified by the |
scope | The scope within which to search for the bean specified by the |
scrolling | Should scroll bars be created unconditionally (yes), never (no), or only when needed (auto)? [RT Expr] |
style | CSS styles to be applied to this element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
transaction | If set to |
hidden - Render A Hidden Field
Renders an HTML <input> element of type hidden, populated from the specified value or the specified property of the bean associated with our current form. This tag is only valid when nested inside a form tag body.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of this input field, and the name of the corresponding bean property if value is not specified. The corresponding bean property (if any) must be of type String. [Required] [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value to which this field should be initialized. [Use the corresponding bean property value] [RT Expr] |
write | Should the value of this field also be rendered to the response page to make it visible, in addition to creating an HTML type="hidden" element? By default, only the hidden element is created. [RT Expr] |
html - Render an HTML <html> Element
Renders an HTML <html>
element with language attributes extracted from the user's current Locale object, if there is one.
Attribute Name | Description |
---|---|
lang | Renders a lang attribute with the locale stored in the user's session. If not found in the session, the language from the Accept-Language HTTP header is used. If still not found, the default language for the server is used. Since: Struts 1.2 [RT Expr] |
locale | Set to DEPRECATED: Creating a session is undesirable for apps that don't support them. Use the lang attribute to achieve the same functionality without creating a session. [RT Expr] |
xhtml | Set to Since: Struts 1.1 [RT Expr] |
image - Render an input tag of type "image"
Renders an HTML <input>
tag of type "image". The base URL for this image is calculated directly based on the value specified in the src
or page
attributes, or indirectly by looking up a message resource string based on the srcKey
or pageKey
attributes. You must specify exactly one of these attributes.
If you would like to obtain the coordinates of the mouse click that submitted this request, see the information below on the property
attribute.
This tag is only valid when nested inside a form tag body.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
align | The alignment option for this image. DEPRECATED: The align attribute is deprecated in HTML 4.x. The suggested alternative is to use CSS. Please see http://www.w3.org/TR/REC-html40/struct/objects.html#h-13.7.4 for more details. [RT Expr] |
alt | The alternate text for this image. [RT Expr] |
altKey | The message resources key of the alternate text for this image. [RT Expr] |
border | The width (in pixels) of the border around this image. [RT Expr] |
bundle | The servlet context attribute key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "propertyName[34]". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
locale | The session attribute key for the Locale used to select internationalized messages. If not specified, defaults to the Struts standard value. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
page | The module-relative path of the image for this input tag. [RT Expr] |
pageKey | The key of the message resources string specifying the module-relative path of the image for this input tag. [RT Expr] |
property | The property name of this image tag. The parameter names for the request will appear as "property.x" and "property.y", the x and y representing the coordinates of the mouse click for the image. A way of retrieving these values through a form bean is to define getX(), getY(), setX(), and setY() methods, and specify your property as a blank string (property=""). [RT Expr] |
src | The source URL of the image for this input tag. [RT Expr] |
srcKey | The key of the message resources string specifying the source URL of the image for this input tag. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | The value that will be submitted if this image button is pressed. [RT Expr] |
img - Render an HTML img tag
Renders an HTML <img>
element with the image at the specified URL. Like the link tag, URL rewriting will be applied automatically to the value specified in src
, page
, or action
to maintain session state in the absence of cookies. This will allow dynamic generation of an image where the content displayed for this image will be taken from the attributes of this tag.
The base URL for this image is calculated directly based on the value specified in src
, page
, or action
or page
, or indirectly by looking up a message resource string based on the srcKey
or pageKey
attributes. You must specify exactly one of these attributes.
Normally, the src
, page
, or action
that you specify will be left unchanged (other than URL rewriting if necessary). However, there are two ways you can append one or more dynamically defined query parameters to the src
URL -- specify a single parameter with the paramId
attribute (at its associated attributes to select the value), or specify the name
(and optional property
) attributes to select a java.util.Map
bean that contains one or more parameter ids and corresponding values.
To specify a single parameter, use the paramId
attribute to define the name of the request parameter to be submitted. To specify the corresponding value, use one of the following approaches:
- Specify only the
paramName
attribute - The named JSP bean (optionally scoped by the value of theparamScope
attribute) must identify a value that can be converted to a String. - Specify both the
paramName
andparamProperty
attributes - The specified property getter will be called on the JSP bean identified by theparamName
(and optionalparamScope
) attributes, in order to select a value that can be converted to a String.
If you prefer to specify a java.util.Map
that contains all of the request parameters to be added to the hyperlink, use one of the following techniques:
- Specify only the
name
attribute - The named JSP bean (optionally scoped by the value of thescope
attribute) must identify ajava.util.Map
containing the parameters. - Specify both
name
andproperty
attributes - The specified property getter method will be called on the bean identified by thename
(and optionalscope
) attributes, in order to return thejava.util.Map
containing the parameters.
As the Map
is processed, the keys are assumed to be the names of query parameters to be appended to the src
URL. The value associated with each key must be either a String or a String array representing the parameter value(s), or an object whose toString() method will be called. If a String array is specified, more than one value for the same query parameter name will be created.
You can specify the alternate text for this image (which most browsers display as pop-up text block when the user hovers the mouse over this image) either directly, through the alt
attribute, or indirectly from a message resources bundle, using the bundle
and altKey
attributes.
Attribute Name | Description |
---|---|
align | Where the image is aligned to. Can be one of the following attributes:
|
alt | And alternative text to be displayed in browsers that don't support graphics. Also used often as type of context help over images. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
border | The width of the border surrounding the image. [RT Expr] |
bundle | The servlet context attribute key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet. [RT Expr] |
contextRelative | If set to "true", this "anchors" the image src at the application context rather than the module context when the 'page' attribute is used to specify an image path. DEPRECATED:Use module attribute instead; will be removed in a release afer 1.2.0. [RT Expr] |
height | The height of the image being displayed. This parameter is very nice to specify (along with |
hspace | The amount of horizontal spacing between the icon and the text. The text may be in the same paragraph, or be wrapped around the image. [RT Expr] |
imageName | The scriptable name to be defined within this page, so that you can reference it with intra-page scripts. In other words, the value specified here will render a "name" element in the generated image tag. [RT Expr] |
ismap | The name of the server-side map that this image belongs to. [RT Expr] |
locale | The name of the request or session Locale attribute used to look up internationalized messages. [RT Expr] |
lowsrc | An image for people with low resolution graphics cards. DEPRECATED: This attribute is not defined in the HTML 4.01 spec and will be removed in a future version of Struts. [RT Expr] |
name | The name of a JSP bean that contains a |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onkeydown | JavaScript event handler that is executed when this element receives a key down event. [RT Expr] |
onkeypress | JavaScript event handler that is executed when this element receives a key press event. [RT Expr] |
onkeyup | JavaScript event handler that is executed when this element receives a key up event. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
paramId | The name of the request parameter that will be dynamically added to the generated src URL. The corresponding value is defined by the |
page | The module-relative path, starting with a slash, of the image to be displayed by this tag. The rendered URL for this image will automatically prepend the context path of this web application (in the same manner as the |
pageKey | The message key, in the message resources bundle named by the |
action | The action, starting with a slash, that will render the image to be displayed by this tag. The rendered URL for this image will automatically prepend the context path of this web application (in the same manner as the Additionally, you can specify a |
module | Prefix name of a Note: Use "" to map to the default module. [RT Expr] |
paramName | The name of a JSP bean that is a String containing the value for the request parameter named by |
paramProperty | The name of a property of the bean specified by the |
paramScope | The scope within which to search for the bean specified by the |
property | The name of a property of the bean specified by the |
scope | The scope within which to search for the bean specified by the |
src | The URL to which this image will be transferred from This image may be dynamically modified by the inclusion of query parameters, as described in the tag description. This value will be used unmodified (other than potential URL rewriting) as the value of the "src" attribute in the rendered tag. You must specify either the |
srcKey | The message key, in the message resources bundle named by the |
style | CSS styles to be applied to this element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
useLocalEncoding | If set to |
usemap | The name of the map as defined within this page for mapping hot-spot areas of this image. [RT Expr] |
vspace | The amount of vertical spacing between the icon and the text, above and below. [RT Expr] |
width | The width of the image being displayed. This parameter is very nice to specify (along with |
javascript - Render JavaScript validation based on the validation rules loaded by the ValidatorPlugIn.
Render JavaScript validation based on the validation rules loaded by the ValidatorPlugIn
. The set of validation rules that should be generated is based on the formName attribute passed in, which should match the name attribute of the form element in the xml file.
The dynamicJavascript and staticJavascript attributes default to true, but if dynamicJavascript is set to true
and staticJavascript is set to false
then only the dynamic JavaScript will be rendered. If dynamicJavascript is set to false
and staticJavascript is set to true
then only the static JavaScript will be rendered which can then be put in separate JSP page so the browser can cache the static JavaScript.
Attribute Name | Description |
---|---|
cdata | If set to "true" and XHTML has been enabled, the JavaScript will be wrapped in a CDATA section to prevent XML parsing. The default is "true" to comply with the W3C's recommendation. Since: Struts 1.1 [RT Expr] |
dynamicJavascript | Whether or not to render the dynamic JavaScript. Defaults to |
formName | The key (form name) to retrieve a specific set of validation rules. If "dynamicJavascript" is set to |
method | The alternate JavaScript method name to be used instead of the of the default. The default is 'validate' concatenated in front of the key (form name) passed in (ex: validateRegistrationForm). [RT Expr] |
page | The current page of a set of validation rules if the page attribute for the field element in the xml file is in use. [RT Expr] |
scriptLanguage | The <script> element will not contain a language attribute when this is set to false. The default is true but this property is ignored in XHTML mode. Since: Struts 1.2 [RT Expr] |
src | The src attribute's value when defining the html script element. [RT Expr] |
staticJavascript | Whether or not to render the static JavaScript. Defaults to |
htmlComment | Whether or not to enclose the javascript with HTML comments. This attribute is ignored in XHTML mode because the script would be deleted by the XML parser. See the cdata attribute for details on hiding scripts from XML parsers. Defaults to |
link - Render an HTML anchor or hyperlink
Renders an HTML <a>
element as an anchor definition (if "linkName" is specified) or as a hyperlink to the specified URL. URL rewriting will be applied automatically, to maintain session state in the absence of cookies. The content displayed for this hyperlink will be taken from the body of this tag.
The base URL for this hyperlink is calculated based on which of the following attributes you specify (you must specify exactly one of them):
- forward - Use the value of this attribute as the name of a global
ActionForward
to be looked up, and use the module-relative or context-relative URI found there. - action - Use the value of this attribute as the name of a
Action
to be looked up, and use the module-relative or context-relative URI found there. - href - Use the value of this attribute unchanged.
- page - Use the value of this attribute as a module-relative URI, and generate a server-relative URI by including the context path and module prefix.
Normally, the hyperlink you specify with one of the attributes described in the previous paragraph will be left unchanged (other than URL rewriting if necessary). However, there are two ways you can append one or more dynamically defined query parameters to the hyperlink -- specify a single parameter with the paramId
attribute (and its associated attributes to select the value), or specify the name
(and optional property
) attributes to select a java.util.Map
bean that contains one or more parameter ids and corresponding values.
To specify a single parameter, use the paramId
attribute to define the name of the request parameter to be submitted. To specify the corresponding value, use one of the following approaches:
- Specify only the
paramName
attribute - The named JSP bean (optionally scoped by the value of theparamScope
attribute) must identify a value that can be converted to a String. - Specify both the
paramName
andparamProperty
attributes - The specified property getter method will be called on the JSP bean identified by theparamName
(and optionalparamScope
) attributes, in order to select a value that can be converted to a String.
If you prefer to specify a java.util.Map
that contains all of the request parameters to be added to the hyperlink, use one of the following techniques:
- Specify only the
name
attribute - The named JSP bean (optionally scoped by the value of thescope
attribute) must identify ajava.util.Map
containing the parameters. - Specify both
name
andproperty
attributes - The specified property getter method will be called on the bean identified by thename
(and optionalscope
) attributes, in order to return thejava.util.Map
containing the parameters.
As the Map
is processed, the keys are assumed to be the names of query parameters to be appended to the hyperlink. The value associated with each key must be either a String or a String array representing the parameter value(s), or an object whose toString() method will be called. If a String array is specified, more than one value for the same query parameter name will be created.
Additionally, you can request that the current transaction control token, if any, be included in the generated hyperlink by setting the transaction
attribute to true
. You can also request that an anchor ("#xxx") be added to the end of the URL that is created by any of the above mechanisms, by using the anchor
attribute.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
action | Logical name of a Additionally, you can specify a |
module | Prefix name of a Note: Use "" to map to the default module. [RT Expr] |
anchor | Optional anchor tag ("#xxx") to be added to the generated hyperlink. Specify this value without any "#" character. [RT Expr] |
forward | Logical name of a global |
href | The URL to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the |
indexed | Valid only inside of logic:iterate tag. If true then indexed parameter with name from indexId attribute will be added to the query string. Indexed parameter looks like "index[32]". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
indexId | By this attribute different name for the indexed parameter can be specified. Take a look to the "indexed" attribute for details. [RT Expr] |
linkName | The anchor name to be defined within this page, so that you can reference it with intra-page hyperlinks. In other words, the value specified here will render a "name" element in the generated anchor tag. [RT Expr] |
name | The name of a JSP bean that contains a |
onblur | JavaScript event handler that is executed when this element loses input focus. [RT Expr] |
onclick | JavaScript event handler that is executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler that is executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler that is executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler that is executed when this element receives a key down event. [RT Expr] |
onkeypress | JavaScript event handler that is executed when this element receives a key press event. [RT Expr] |
onkeyup | JavaScript event handler that is executed when this element receives a key up event. [RT Expr] |
onmousedown | JavaScript event handler that is executed when this element receives a mouse down event. [RT Expr] |
onmousemove | JavaScript event handler that is executed when this element receives a mouse move event. [RT Expr] |
onmouseout | JavaScript event handler that is executed when this element receives a mouse out event. [RT Expr] |
onmouseover | JavaScript event handler that is executed when this element receives a mouse over event. [RT Expr] |
onmouseup | JavaScript event handler that is executed when this element receives a mouse up event. [RT Expr] |
page | The module-relative path (beginning with a "/" character) to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the |
paramId | The name of the request parameter that will be dynamically added to the generated hyperlink. The corresponding value is defined by the |
paramName | The name of a JSP bean that is a String containing the value for the request parameter named by |
paramProperty | The name of a property of the bean specified by the |
paramScope | The scope within which to search for the bean specified by the |
property | The name of a property of the bean specified by the |
scope | The scope within which to search for the bean specified by the |
style | CSS styles to be applied to this element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
target | The window target in which the resource requested by this hyperlink will be displayed, for example in a framed presentation. [RT Expr] |
title | The advisory title for this hyperlink. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
transaction | If set to |
useLocalEncoding | If set to |
messages - Conditionally display a set of accumulated messages.
Displays a set of messages prepared by a business logic component and stored as an ActionMessages
object, ActionErrors
object, a String, or a String array in any scope. If such a bean is not found, nothing will be rendered.
In order to use this tag successfully, you must have defined an application scope MessageResources
bean under the default attribute name.
Attribute Name | Description |
---|---|
id | The name of a page scope JSP bean that will contain the current element of the collection of messages on each iteration, if it is not null . [Required] |
bundle | The servlet context attribute key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet. [RT Expr] |
locale | The session attribute key for the Locale used to select messages to be displayed. If not specified, defaults to the Struts standard value. [RT Expr] |
name | Name of the bean in any scope under which our messages have been stored. If not present, the name specified by the Globals.ERROR_KEY constant string will be used. [RT Expr] |
property | Name of the property for which messages should be displayed. If not specified, all messages (regardless of property) are displayed. [RT Expr] |
header | This value is an optional message resource key that will be printed before the iteration of messages begins. [RT Expr] |
footer | This value is an optional message resource key that will be printed after the iteration of messages has finished. [RT Expr] |
message | By default the tag will retrieve the bean it will iterate over from the Globals.ERROR_KEY constant string, but if this attribute is set to 'true' the bean will be retrieved from the Globals.MESSAGE_KEY constant string. Also if this is set to 'true', any value assigned to the name attribute will be ignored. [RT Expr] |
multibox - Render A Checkbox Input Field
Renders an HTML <input> element of type checkbox
, whose "checked" status is initialized based on whether the specified value matches one of the elements of the underlying property's array of current values. This element is useful when you have large numbers of checkboxes, and prefer to combine the values into a single array-valued property instead of multiple boolean properties. This tag is only valid when nested inside a form tag body.
WARNING: In order to correctly recognize cases where none of the associated checkboxes are selected, the ActionForm
bean associated with this form must include a statement setting the corresponding array to zero length in the reset()
method.
The value to be returned to the server, if this checkbox is selected, must be defined by one of the following methods:
- Specify a
value
attribute, whose contents will be used literally as the value to be returned. - Specify no
value
attribute, and the nested body content of this tag will be used as the value to be returned.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | The value to be transmitted if this checkbox is checked when the form is submitted. [RT Expr] |
option - Render A Select Option
Render an HTML <option>
element, representing one of the choices for an enclosing <select>
element. The text displayed to the user comes from either the body of this tag, or from a message string looked up based on the bundle
, locale
, and key
attributes.
If the value of the corresponding bean property matches the specified value, this option will be marked selected. This tag is only valid when nested inside a <html:select>
tag body.
Attribute Name | Description |
---|---|
bundle | The servlet context attributes key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet. [RT Expr] |
disabled | Set to true if this option should be disabled. [RT Expr] |
key | If specified, defines the message key to be looked up in the resource bundle specified by bundle for the text displayed to the user for this option. If not specified, the text to be displayed is taken from the body content of this tag. [RT Expr] |
locale | The session attributes key for the Locale instance to use for looking up the message specified by the key attribute. If not specified, uses the standard Struts session attribute name. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
value | Value to be submitted for this field if this option is selected by the user. [Required] [RT Expr] |
options - Render a Collection of Select Options
Renders a set of HTML <option>
elements, representing possible choices for a <select>
element. This tag can be used multiple times within a single <html:select>
element, either in conjunction with or instead of one or more <html:option>
or <html:optionsCollection>
elements.
This tag operates in one of two major modes, depending on whether or not the collection
attribute is specified. If the collection
attribute is included, the following rules apply:
- The collection attribute is interpreted as the name of a JSP bean, in some scope, that itself represents a collection of individual beans, one per option value to be rendered.
- The property attribute is interpreted as the name of a property of the individual beans included in the collection, and is used to retrieve the value that will be returned to the server if this option is selected.
- The labelProperty attribute is interpreted as the name of a property of the individual beans included in the collection, and is used to retrieve the label that will be displayed to the user for this option. If the
labelProperty
attribute is not specified, the property named by theproperty
attribute will be used to select both the value returned to the server and the label displayed to the user for this option.
If the collection
attribute is not specified, the rules described in the remainder of this section apply.
The collection of values actually selected depends on the presence or absence of the name
and property
attributes. The following combinations are allowed:
- Only
name
is specified - The value of this attribute is the name of a JSP bean in some scope that is the collection. - Only
property
is specified - The value of this attribute is the name of a property of the ActionForm bean associated with our form, which will return the collection. - Both
name
andproperty
are specified - The value of thename
attribute identifies a JSP bean in some scope. The value of theproperty
attribute is the name of some property of that bean which will return the collection.
The collection of labels displayed to the user can be the same as the option values themselves, or can be different, depending on the presence or absence of the labelName
and labelProperty
attributes. If this feature is used, the collection of labels must contain the same number of elements as the corresponding collection of values. The following combinations are allowed:
- Neither
labelName
norlabelProperty
is specified - The labels will be the same as the option values themselves. - Only
labelName
is specified - The value of this attribute is the name of a JSP bean in some scope that is the collection. - Only
labelProperty
is specified - The value of this attribute is the name of a property of the ActionForm bean associated with our form, which will return the collection. - Both
labelName
andlabelProperty
are specified - The value of thelabelName
attribute identifies a JSP bean in some scope. The value of thelabelProperty
attribute is the name of some property of that bean which will return the collection.
Note that this tag does not support a styleId
attribute, as it would have to apply the value to all the option
elements created by this element, which would mean that more than one id
element might have the same value, which the HTML specification says is illegal.
Attribute Name | Description |
---|---|
collection | Name of the JSP bean (in some scope) which is itself a Collection of other beans, each of which has properties named by the "property" and "labelProperty" attributes that are used to retrieve the value and label for each option, respectively. [RT Expr] |
filter | Set to false if you do NOT want the option labels filtered for sensitive characters in HTML. By default, such values are filtered. [RT Expr] |
labelName | Name of the JSP bean (in some scope) containing the collection of labels to be displayed to the user for these options. [RT Expr] |
labelProperty | Property of the form bean, or the bean specified by the labelName attribute, that will return the collection of labels to be displayed to the user for these options. [RT Expr] |
name | Name of the JSP bean (in some scope) containing the collection of values to be returned to the server for these options. If not specified, the form bean associated with our form is assumed. [RT Expr] |
property | Property of the form bean, or the bean specified by the name attribute, that will return the collection of values to returned to the server for these options. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
optionsCollection - Render a Collection of Select Options
Renders a set of HTML <option>
elements, representing possible choices for a <select>
element. This tag can be used multiple times within a single <html:select>
element, either in conjunction with or instead of one or more <html:option>
or <html:options>
elements.
This tag operates on a collection of beans, where each bean has a label property and a value property. The actual names of these properties can be configured using the label
and value
attributes of this tag.
This tag differs from the <html:options>
tag in that it makes more consistent use of the name
and property
attributes, and allows the collection to be more easily obtained from the enclosing form bean.
Note that this tag does not support a styleId
attribute, as it would have to apply the value to all the option
elements created by this element, which would mean that more than one id
element might have the same value, which the HTML specification says is illegal.
Attribute Name | Description |
---|---|
filter | Set to false if you do NOT want the option labels filtered for sensitive characters in HTML. By default, such values are filtered. [RT Expr] |
label | The property of the bean within the collection which represents the label to be rendered for each option. Defaults to "label". [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
property | The property of the form bean, or the bean specified by the name attribute, that will return the collection of objects to be rendered for these options. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
value | The property of the bean within the collection which represents the value to be rendered for each option. Defaults to "value". [RT Expr] |
password - Render A Password Input Field
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
maxlength | Maximum number of input characters to accept. [No limit] [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr] |
readonly | Set to true if this input field should be read only. [RT Expr] |
redisplay | Boolean flag indicating whether or not existing values will be redisplayed if they exist. Even though the redisplayed value will be shown as asterisks on the visible HTML page, the cleartext of the actual password value will be visible though the "Show Page Source" menu option of the client browser. You may wish to set this value to false on login pages. Defaults to true for consistency with all other form tags that redisplay their contents. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
size | Number of character positions to allocate. [Browser default] [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value of the label to be placed on this button. This value will also be submitted as the value of the specified request parameter. [Body of this tag (if any)] [RT Expr] |
radio - Render A Radio Button Input Field
Renders an HTML <input> element of type radio, populated from the specified property of the bean associated with our current form. This tag is only valid when nested inside a form tag body.
If an iterator is used to render a series of radio tags, the idName attribute may be used to specify the name of the bean exposed by the iterator. In this case, the value attribute is used as the name of a property on the idName bean that returns the value of the radio tag in this iteration.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
property | The corresponding bean property for this radio tag. [Required] [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | The value of the radio tag. [Required] [RT Expr] |
idName | Name of the bean (in some scope) that will return the value of the radio tag. Usually exposed by an iterator. When the idName attribute is present, the value attribute is used as the name of the property on the idName bean that will return the value of the radio tag for this iteration. Since: Struts 1.1 [RT Expr] |
reset - Render A Reset Button Input Field
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the input field that will be generated. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value of the label to be placed on this button. [Body of this tag (if any), or "Reset"] [RT Expr] |
rewrite - Render an URI
Renders a request URI based on exactly the same rules as the link
tag does, but without creating the <a>
hyperlink. This value is useful when you want to generate a string constant for use by a JavaScript procedure.
Attribute Name | Description |
---|---|
action | Logical name of a Additionally, you can specify a Since: Struts 1.2.0 [RT Expr] |
module | Prefix name of a Note: Use "" to map to the default module. [RT Expr] |
anchor | Optional anchor tag ("#xxx") to be added to the generated hyperlink. Specify this value without any "#" character. [RT Expr] |
forward | Logical name of a global |
href | The URL to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the |
name | The name of a JSP bean that contains a |
page | The module-relative path (beginning with a "/" character) to which this hyperlink will transfer control if activated. This hyperlink may be dynamically modified by the inclusion of query parameters, as described in the tag description. You must specify exactly one of the |
paramId | The name of the request parameter that will be dynamically added to the generated hyperlink. The corresponding value is defined by the |
paramName | The name of a JSP bean that is a String containing the value for the request parameter named by |
paramProperty | The name of a property of the bean specified by the |
paramScope | The scope within which to search for the bean specified by the |
property | The name of a property of the bean specified by the |
scope | The scope within which to search for the bean specified by the |
transaction | If set to |
useLocalEncoding | If set to |
select - Render A Select Element
Renders an HTML <select> element, associated with a bean property specified by our attributes. This tag is only valid when nested inside a form tag body.
This tag operates in two modes, depending upon the state of the multiple
attribute, which affects the data type of the associated property you should use:
- multiple="true" IS NOT selected - The corresponding property should be a scalar value of any supported data type.
- multiple="true" IS selected - The corresponding property should be an array of any supported data type.
WARNING: In order to correctly recognize cases where no selection at all is made, the ActionForm
bean associated with this form must include a statement resetting the scalar property to a default value (if multiple
is not set), or the array property to zero length (if multiple
is set) in the reset()
method.
Attribute Name | Description |
---|---|
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
multiple | If set to any arbitrary value, the rendered select element will support multiple selections. [RT Expr] |
name | The attribute name of the bean whose properties are consulted to determine which option should be pre-selected when rendering this input field. If not specified, the bean associated with the enclosing <html:form> tag is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
size | The number of available options displayed at one time. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | The value to compare with for marking an option selected. [RT Expr] |
submit - Render A Submit Button
submit
.
If a graphical button is needed (a button with an image), then the image
tag is more appropriate.
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "propertyName[34]". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of the request parameter that will be included with this submission, set to the specified value. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | The value of the button label. [RT Expr] |
text - Render An Input Field of Type text
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
maxlength | Maximum number of input characters to accept. [No limit] [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of this input field, and the name of the corresponding bean property if value is not specified. The corresponding bean property (if any) must be of type String. [Required] [RT Expr] |
readonly | Set to true if this input field should be read only. [RT Expr] |
size | Number of character positions to allocate. [Browser default] [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value to which this field should be initialized. [Use the corresponding bean property value] [RT Expr] |
textarea - Render A Textarea
Attribute Name | Description |
---|---|
accesskey | The keyboard character used to move focus immediately to this element. [RT Expr] |
alt | The alternate text for this element. [RT Expr] |
altKey | The message resources key of the alternate text for this element. [RT Expr] |
cols | The number of columns to display. [RT Expr] |
disabled | Set to true if this input field should be disabled. [RT Expr] |
indexed | Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr] |
name | The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr] |
onblur | JavaScript event handler executed when this element loses input focus. [RT Expr] |
onchange | JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr] |
onclick | JavaScript event handler executed when this element receives a mouse click. [RT Expr] |
ondblclick | JavaScript event handler executed when this element receives a mouse double click. [RT Expr] |
onfocus | JavaScript event handler executed when this element receives input focus. [RT Expr] |
onkeydown | JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr] |
onkeypress | JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr] |
onkeyup | JavaScript event handler executed when this element has focus and a key is released. [RT Expr] |
onmousedown | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr] |
onmousemove | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr] |
onmouseout | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr] |
onmouseover | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr] |
onmouseup | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr] |
property | Name of this input field, and the name of the corresponding bean property if value is not specified. The corresponding bean property (if any) must be of type String. [Required] [RT Expr] |
readonly | Set to true if this input field should be read only. [RT Expr] |
rows | The number of rows to display. [RT Expr] |
style | CSS styles to be applied to this HTML element. [RT Expr] |
styleClass | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr] |
styleId | Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr] |
tabindex | The tab order (ascending positive integers) for this element. [RT Expr] |
title | The advisory title for this element. [RT Expr] |
titleKey | The message resources key for the advisory title for this element. [RT Expr] |
value | Value to which this field should be initialized. [Use the corresponding bean property value] [RT Expr] |
xhtml - Render HTML tags as XHTML
Using this tag in a page tells all other html taglib tags to render themselves as XHTML 1.0. This is useful when composing pages with JSP includes or Tiles. <html:html xhtml="true"> has a similar effect. This tag has no attributes; you use it like this: <html:xhtml/>.
Note: Included pages do not inherit the rendering style of the including page. Each JSP fragment or Tile must use this tag to render as XHTML.