The base URL for this image is calculated directly based on
the value specified in src
, page
, or
action
or page
,
or indirectly by looking up a message resource string based on
the srcKey
or pageKey
attributes.
You must specify exactly one of these
attributes.
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]
|
contextRelative |
If set to "true", this "anchors" the image src at the
application context rather than the module context when the
'page' attribute is used to specify an image path.
DEPRECATED:Use module attribute instead; will be removed in a release afer 1.2.0.
[RT Expr]
|
height |
The height of the image being displayed. This parameter
is very nice to specify (along with 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 |
An image for people with low resolution graphics cards.
DEPRECATED:
This attribute is not defined in the HTML 4.01 spec and
will be removed in a future version of Struts.
[RT Expr]
|
name |
The name of a JSP bean that contains a 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]
|
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]
|
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]
|
action |
The action, starting with a slash, that will render
the image to be displayed by this tag. The rendered
URL for this image will automatically prepend the context
path of this web application (in the same manner as the
action attribute on the link tag works),
in addition to any necessary URL rewriting. You
must specify the action ,
page
attribute or the src attribute.
Additionally, you can specify a module prefix
for linking to other modules.
[RT Expr]
|
module |
Prefix name of a Module that
contains the action mapping for the Action
that is specified by the action attribute.
You must specify an action
attribute for this to have an effect.
Note: Use "" to map to the default module.
[RT Expr]
|
paramName |
The name of a JSP bean that is a String containing the
value for the request parameter named by 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]
|
useLocalEncoding |
If set to true , LocalCharacterEncoding will be
used, that is, the characterEncoding set to the HttpServletResponse,
as prefered character encoding rather than UTF-8, when
URLEncoding is done on parameters of the URL.
[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]
|