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 |
---|
server |
The server name to use instead of request.getServerName().
(RT EXPR)
| target |
The window target for this base reference.
(RT EXPR)
|
|
Back to top 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)
|
|
Back to top 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)
|
|
Back to top 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)
|
|
Back to top 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
Action.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)
|
|
Back to top 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 |
---|
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)
| 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. 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)
|
|
Back to top 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 associated form bean is determined in one of two ways:
-
If the
name and type attributes
are not specified, then the form bean will be located, and
created if necessary, based on the form bean specification
for the associated ActionMapping .
-
If the
name and type attributes
are specified, then the form bean will be located, and created
if necessary, using the specified values for name ,
type and scope .
NOTE: The use of the name ,
type and scope attributes is
deprecated. The preferred usage is to allow the appropriate
values to be determined automatically from the corresponding
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
path attribute of the corresponding
<action> element, optionally
followed by the correct extension suffix.
If you are using path mapping to select the
controller servlet, this value should be exactly equal
to the path attribute of the corresponding
<action> element.
(REQUIRED)
(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 | Since: Struts 1.1
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.
(RT EXPR)
| method |
The HTTP method that will be used to submit this request
(GET, POST). [POST]
(RT EXPR)
| name | DEPRECATED:
The bean name will be determined from the corresponding
ActionMapping.
Name of the request scope or session scope bean
(as defined by the scope attribute)
whose properties will be used to populate the input
field values. If no such bean is found, a new bean
will be created and added to the appropriate scope,
using the Java class name specified by the
type attribute.
If this attribute is not specified, the name of the bean
will be calculated by using the value of the
action attribute to look up the
corresponding ActionMapping element, from which
the specified form bean name will be selected.
(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)
| scope | DEPRECATED:
The bean scope will be determined from the corresponding
ActionMapping.
Scope within which the form bean associated with
this input form will be accessed or created (must be
either request or session ).
If this attribute is not specified, the scope of the bean
will be calculated by using the value of the
action attribute to look up the
corresponding ActionMapping element, from which
the specified form bean scope will be selected.
(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)
| type | DEPRECATED:
The bean type will be determined from the corresponding
ActionMapping.
Fully qualified Java class name of the form bean to
be created, if no such bean is found in the specified
scope.
If this attribute is not specified, the type of the bean
will be calculated by using the value of the
action attribute to look up the
corresponding ActionMapping element, from which
the specified form bean type will be selected.
(RT EXPR)
|
|
Back to top 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 application-relative or context-relative
URI found there.
- href - Use the value of this attribute unchanged.
- page - Use the value of this attribute as a
application-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 the
paramScope attribute) must identify a value
that can be converted to a String.
- Specify both the
paramName and
paramProperty attributes - The specified
property getter method will be called on the JSP bean
identified by the paramName (and optional
paramScope ) 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
the scope attribute) must identify a
java.util.Map containing the parameters.
- Specify both
name and
property attributes - The specified
property getter method will be called on the bean
identified by the name (and optional
scope ) attributes, in order to return the
java.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 Action that
contains the actual content-relative URI of the destination
of this transfer. 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 action attribute, the
forward attribute, the
href attribute,
or the page attribute.
(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 ActionForward that
contains the actual content-relative URI of the destination
of this transfer. 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 action attribute, the
forward attribute, the
href attribute,
or the page attribute.
(RT EXPR)
| frameborder |
Should a frame border be generated around this frame (1)
or not (0)?
(RT EXPR)
| frameName |
Value for the name attribute of the rendered
<frame> element.
(RT EXPR)
| 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 action attribute, the
forward attribute, the
href attribute,
or the page attribute.
(RT EXPR)
| longdesc |
URI of a long description of the frame. This description
should supplement the short description provided by the
title attribute, and may be particularly useful
for non-visual user agents.
(RT EXPR)
| 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 Map
representing the query parameters (if property
is not specified), or a JSP bean whose property getter is
called to return a Map (if property
is specified).
(RT EXPR)
| 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 action attribute, the
forward attribute, the
href attribute,
or the page attribute.
(RT EXPR)
| paramId |
The name of the request parameter that will be dynamically
added to the generated hyperlink. The corresponding value is
defined by the paramName and (optional)
paramProperty attributes, optionally scoped by
the paramScope attribute
(RT EXPR)
| paramName |
The name of a JSP bean that is a String containing the
value for the request parameter named by paramId
(if paramProperty is not specified), or a JSP
bean whose property getter is called to return a String
(if paramProperty is specified). The JSP bean
is constrained to the bean scope specified by the
paramScope property, if it is specified.
(RT EXPR)
| paramProperty |
The name of a property of the bean specified by the
paramName attribute, whose return value must
be a String containing the value of the request parameter
(named by the paramId attribute) that will be
dynamically added to this hyperlink.
(RT EXPR)
| paramScope |
The scope within which to search for the bean specified
by the paramName attribute. If not specified,
all scopes are searched.
(RT EXPR)
| property |
The name of a property of the bean specified by the
name attribute, whose return value must be
a java.util.Map containing the query parameters
to be added to the hyperlink. You must
specify the name attribute if you specify
this attribute.
(RT EXPR)
| scope |
The scope within which to search for the bean specified
by the name attribute. If not specified, all
scopes are searched.
(RT EXPR)
| 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 true , any current transaction
control token will be included in the generated hyperlink,
so that it will pass an isTokenValid() test
in the receiving Action.
(RT EXPR)
|
|
Back to top 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)
| 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)
|
|
Back to top 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 |
---|
locale |
Set to true in order to store a Locale in the session based on
the current request's Accept-Language header (if
any) if none has currently been set. This attribute will create a session
if one does not already exist. The lang attribute is rendered with the
appropriate language code.
(RT EXPR)
| xhtml |
Set to true in order to render an
xml:lang attribute on the generated
html element. This also causes all other
html tags to render as xhtml.
(RT EXPR)
|
|
Back to top 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.
The alignment option for this image. 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)
|
|
Back to top 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 or page ,
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 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 or page 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 the
paramScope attribute) must identify a value
that can be converted to a String.
- Specify both the
paramName and
paramProperty attributes - The specified
property getter will be called on the JSP bean identified
by the paramName (and optional
paramScope ) 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
the scope attribute) must identify a
java.util.Map containing the parameters.
- Specify both
name and
property attributes - The specified
property getter method will be called on the bean
identified by the name (and optional
scope ) attributes, in order to return the
java.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:
- left - left justify, wrapping text on right
- right -right justify, wrapping test on left
- top - aligns the image with the top of the text on
the same row
- middle - aligns the image's vertical center with the
text base line
- bottom - aligns the image with the bottom of the
text's base line
- texttop - aligns the image's top with that of the
text font on the same line
- absmiddle - aligns the image's vertical center with the
absolute center of the text
- absbottom - aligns the image with the absolute bottom
of the text font on the same row
(RT EXPR)
| 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)
| height |
The height of the image being displayed. This parameter
is very nice to specify (along with width )
to help the browser render the page faster.
(RT EXPR)
| 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 |
DEPRECATED - This attribute is not defined
in the HTML 4.01 spec and will be removed in a future version of Struts.
An image for people with low resolution graphics cards.
(RT EXPR)
| name |
The name of a JSP bean that contains a Map
representing the query parameters (if property
is not specified), or a JSP bean whose property getter is
called to return a Map (if property
is specified).
(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)
| 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)
| 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
page attribute on the link tag works),
in addition to any necessary URL rewriting. You
must specify either the page
attribute or the src attribute.
(RT EXPR)
| pageKey |
The message key, in the message resources bundle named by
the bundle attribute, of the String to be
used as the module-relative path for this image.
(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 paramName and (optional)
paramProperty attributes, optionally scoped by
the paramScope attribute
(RT EXPR)
| paramName |
The name of a JSP bean that is a String containing the
value for the request parameter named by paramId
(if paramProperty is not specified), or a JSP
bean whose property getter is called to return a String
(if paramProperty is specified). The JSP bean
is constrained to the bean scope specified by the
paramScope property, if it is specified.
(RT EXPR)
| paramProperty |
The name of a property of the bean specified by the
paramName attribute, whose return value must
be a String containing the value of the request parameter
(named by the paramId attribute) that will be
dynamically added to this src URL.
(RT EXPR)
| paramScope |
The scope within which to search for the bean specified
by the paramName attribute. If not specified,
all scopes are searched.
(RT EXPR)
| property |
The name of a property of the bean specified by the
name attribute, whose return value must be
a java.util.Map containing the query parameters
to be added to the src URL. You must
specify the name attribute if you specify
this attribute.
(RT EXPR)
| scope |
The scope within which to search for the bean specified
by the name attribute. If not specified, all
scopes are searched.
(RT EXPR)
| 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 page attribute or the
src attribute.
(RT EXPR)
| srcKey |
The message key, in the message resources bundle named by
the bundle attribute, of the String to be
used as the URL of this image.
(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)
| 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 height )
to help the browser render the page faster.
(RT EXPR)
|
|
Back to top 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 | Since: Struts 1.1
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.
(RT EXPR)
| dynamicJavascript |
Whether or not to render the dynamic JavaScript.
Defaults to true .
| formName |
The key (form name) to retrieve a specific
set of validation rules.
(RT EXPR)
| 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 true .
(RT EXPR)
| 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)
| 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 true .
|
|
Back to top 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 application-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 application-relative or context-relative
URI found there.
- href - Use the value of this attribute unchanged.
- page - Use the value of this attribute as a
application-relative URI, and generate a server-relative
URI by including the context path and application
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 the
paramScope attribute) must identify a value
that can be converted to a String.
- Specify both the
paramName and
paramProperty attributes - The specified
property getter method will be called on the JSP bean
identified by the paramName (and optional
paramScope ) 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
the scope attribute) must identify a
java.util.Map containing the parameters.
- Specify both
name and
property attributes - The specified
property getter method will be called on the bean
identified by the name (and optional
scope ) attributes, in order to return the
java.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 Action that
contains the actual content-relative URI of the destination
of this transfer. 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 action attribute, the
forward attribute, the
href attribute, the linkName
attribute, or the page attribute.
(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 ActionForward that
contains the actual content-relative URI of the destination
of this transfer. 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 action attribute, the
forward attribute, the
href attribute, the linkName
attribute, or the page attribute.
(RT EXPR)
| 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 action attribute, the
forward attribute, the
href attribute, the linkName
attribute, or the page attribute.
(RT EXPR)
| 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 Map
representing the query parameters (if property
is not specified), or a JSP bean whose property getter is
called to return a Map (if property
is specified).
(RT EXPR)
| 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 action attribute,
forward attribute, the
href attribute, the linkName
attribute, or the page attribute.
(RT EXPR)
| paramId |
The name of the request parameter that will be dynamically
added to the generated hyperlink. The corresponding value is
defined by the paramName and (optional)
paramProperty attributes, optionally scoped by
the paramScope attribute
(RT EXPR)
| paramName |
The name of a JSP bean that is a String containing the
value for the request parameter named by paramId
(if paramProperty is not specified), or a JSP
bean whose property getter is called to return a String
(if paramProperty is specified). The JSP bean
is constrained to the bean scope specified by the
paramScope property, if it is specified.
(RT EXPR)
| paramProperty |
The name of a property of the bean specified by the
paramName attribute, whose return value must
be a String containing the value of the request parameter
(named by the paramId attribute) that will be
dynamically added to this hyperlink.
(RT EXPR)
| paramScope |
The scope within which to search for the bean specified
by the paramName attribute. If not specified,
all scopes are searched.
(RT EXPR)
| property |
The name of a property of the bean specified by the
name attribute, whose return value must be
a java.util.Map containing the query parameters
to be added to the hyperlink. You must
specify the name attribute if you specify
this attribute.
(RT EXPR)
| scope |
The scope within which to search for the bean specified
by the name attribute. If not specified, all
scopes are searched.
(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)
| 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 true , any current transaction
control token will be included in the generated hyperlink,
so that it will pass an isTokenValid() test
in the receiving Action.
(RT EXPR)
|
|
Back to top 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 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.
| 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)
| footer |
This value is an optional message resource key that will
be printed after the iteration of messages has finished.
(RT EXPR)
| header |
This value is an optional message resource key that will
be printed before the iteration of messages begins.
(RT EXPR)
| 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)
| 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)
| message |
By default the tag will retrieve the request scope bean it will
iterate over from the Action.ERROR_KEY constant string,
but if this attribute is set to 'true' the request scope bean
will be retrieved from the Action.MESSAGE_KEY
constant string. Also if this is set to 'true', any value
assigned to the name attribute will be ignored.
(RT EXPR)
| name |
Name of the request scope bean under which our messages
have been stored. If not present, the name specified by the
Action.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)
|
|
Back to top 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)
|
|
Back to top 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)
| 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)
| value |
Value to be submitted for this field if this option is
selected by the user.
(REQUIRED)
(RT EXPR)
|
|
Back to top 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 the property 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 and property are specified -
The value of the name attribute identifies a JSP bean
in some scope. The value of the property 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 nor labelProperty 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 and labelProperty are
specified - The value of the labelName attribute
identifies a JSP bean in some scope. The value of the
labelProperty 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)
|
|
Back to top 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)
|
|
Back to top password -
Render A Password Input Field
|
Renders an HTML <input> element of type password, 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)
| 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)
| 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 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)
|
|
Back to top 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)
| idName | Since: Struts 1.1
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.
(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 |
The corresponding bean property for this radio tag.
(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 of the radio tag.
(REQUIRED)
(RT EXPR)
|
|
Back to top reset -
Render A Reset Button Input Field
|
Renders an HTML <input> element of type reset.
| 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)
|
|
Back to top 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 |
---|
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 ActionForward that
contains the actual content-relative URI of the destination
of this transfer. 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 action attribute, the
forward attribute, the
href attribute, or the page
attribute.
(RT EXPR)
| 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 action attribute, the
forward attribute, the
href attribute, or the page
attribute.
(RT EXPR)
| name |
The name of a JSP bean that contains a Map
representing the query parameters (if property
is not specified), or a JSP bean whose property getter is
called to return a Map (if property
is specified).
(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 action attribute, the
forward attribute, the
href attribute, or the page
attribute.
(RT EXPR)
| paramId |
The name of the request parameter that will be dynamically
added to the generated hyperlink. The corresponding value is
defined by the paramName and (optional)
paramProperty attributes, optionally scoped by
the paramScope attribute
(RT EXPR)
| paramName |
The name of a JSP bean that is a String containing the
value for the request parameter named by paramId
(if paramProperty is not specified), or a JSP
bean whose property getter is called to return a String
(if paramProperty is specified). The JSP bean
is constrained to the bean scope specified by the
paramScope property, if it is specified.
(RT EXPR)
| paramProperty |
The name of a property of the bean specified by the
paramName attribute, whose return value must
be a String containing the value of the request parameter
(named by the paramId attribute) that will be
dynamically added to this hyperlink.
(RT EXPR)
| paramScope |
The scope within which to search for the bean specified
by the paramName attribute. If not specified,
all scopes are searched.
(RT EXPR)
| property |
The name of a property of the bean specified by the
name attribute, whose return value must be
a java.util.Map containing the query parameters
to be added to the hyperlink. You must
specify the name attribute if you specify
this attribute.
(RT EXPR)
| scope |
The scope within which to search for the bean specified
by the name attribute. If not specified, all
scopes are searched.
(RT EXPR)
| transaction |
If set to true , any current transaction
control token will be included in the generated hyperlink,
so that it will pass an isTokenValid() test
in the receiving Action.
(RT EXPR)
|
|
Back to top 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)
| size |
The number of available options displayed at one time.
(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 compare with for marking an option selected.
(RT EXPR)
|
|
Back to top submit -
Render A Submit Button
|
Renders an HTML <input> element of type 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)
|
|
Back to top text -
Render An Input Field of Type text
|
Render an input button of type text. 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)
| 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)
|
|
Back to top textarea -
Render A Textarea
|
Render a textarea element. 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)
| 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)
|
|
Back to top xhtml -
Render HTML tags as XHTML |
Using this tag in a page tells all other html taglib tags
to render themselves as XHTML. This is useful
when composing pages with JSP includes or Tiles. This tag has the same effect
as using <html:html xhtml="true">.
| Attribute Name | Description |
---|
|
Back to top
|