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.
| Attributes |
| 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
|
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| alt |
And alternative text to be displayed in browsers that don't support graphics. Also used often as type of context help over images. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| altKey |
The message resources key of the alternate text for this element. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| border |
The width of the border surrounding the image. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| dir |
The direction for weak/neutral text for this element. - Since:
- Struts 1.3.6
|
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| ismap |
The name of the server-side map that this image belongs to. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| lang |
The language code for this element. - Since:
- Struts 1.3.6
|
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| locale |
The name of the request or session Locale attribute used to look up internationalized messages. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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). |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onclick |
| JavaScript event handler executed when this element receives a mouse click. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| ondblclick |
| JavaScript event handler executed when this element receives a mouse double click. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onkeydown |
JavaScript event handler that is executed when this element receives a key down event. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onkeypress |
JavaScript event handler that is executed when this element receives a key press event. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onkeyup |
JavaScript event handler that is executed when this element receives a key up event. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onmousedown |
| JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onmousemove |
| JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onmouseout |
| JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onmouseover |
| JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| onmouseup |
| JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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 |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| paramScope |
The scope within which to search for the bean specified by the paramName attribute. If not specified, all scopes are searched. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| scope |
The scope within which to search for the bean specified by the name attribute. If not specified, all scopes are searched. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| style |
CSS styles to be applied to this element. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| styleClass |
| CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| styleId |
| Identifier to be assigned to this HTML element (renders an "id" attribute). |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| title |
The advisory title for this element. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| titleKey |
The message resources key for the advisory title for this element. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| usemap |
The name of the map as defined within this page for mapping hot-spot areas of this image. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| vspace |
The amount of vertical spacing between the icon and the text, above and below. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|