html
Tag 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.



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

Attributes
accesskey

The keyboard character used to move focus immediately to this element.

 
Required: false
Request-time: false
Type: java.lang.String
align

The alignment option for this image.

 
Required: false
Request-time: false
Type: java.lang.String
alt

The alternate text for this image.

 
Required: false
Request-time: false
Type: java.lang.String
altKey

The message resources key of the alternate text for this image.

 
Required: false
Request-time: false
Type: java.lang.String
border

The width (in pixels) of the border around this 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
disabled
Set to true if this input field should be disabled.
 
Required: false
Request-time: false
Type: java.lang.String
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.
 
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 session attribute key for the Locale used to select internationalized messages. If not specified, defaults to the Struts standard value.

 
Required: false
Request-time: false
Type: java.lang.String
module

Prefix name of a Module that the page or pageKey attributes relate to.

 
Required: false
Request-time: false
Type: java.lang.String
onblur
JavaScript event handler executed when this element loses input focus.
 
Required: false
Request-time: false
Type: java.lang.String
onchange
JavaScript event handler executed when this element loses input focus and its value has changed.
 
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
onfocus
JavaScript event handler executed when this element receives input focus.
 
Required: false
Request-time: false
Type: java.lang.String
onkeydown
JavaScript event handler executed when this element has focus and a key is depressed.
 
Required: false
Request-time: false
Type: java.lang.String
onkeypress
JavaScript event handler executed when this element has focus and a key is depressed and released.
 
Required: false
Request-time: false
Type: java.lang.String
onkeyup
JavaScript event handler executed when this element has focus and a key is released.
 
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
page

The module-relative path of the image for this input tag.

 
Required: false
Request-time: false
Type: java.lang.String
pageKey

The key of the message resources string specifying the module-relative path of the image for this input tag.

 
Required: false
Request-time: false
Type: java.lang.String
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="").

 
Required: false
Request-time: false
Type: java.lang.String
src

The source URL of the image for this input tag.

 
Required: false
Request-time: false
Type: java.lang.String
srcKey

The key of the message resources string specifying the source URL of the image for this input tag.

 
Required: false
Request-time: false
Type: java.lang.String
style
CSS styles to be applied to this HTML element.
 
Required: false
Request-time: false
Type: java.lang.String
styleClass
CSS stylesheet class to be applied to this HTML element (renders a "class" attribute).
 
Required: false
Request-time: false
Type: java.lang.String
styleId
Identifier to be assigned to this HTML element (renders an "id" attribute).
 
Required: false
Request-time: false
Type: java.lang.String
tabindex
The tab order (ascending positive integers) for this element.
 
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
value

The value that will be submitted if this image button is pressed.

 
Required: false
Request-time: false
Type: java.lang.String

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.