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
NameRequiredRequest-timeTypeDescription
accesskeyfalsetruejava.lang.String

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

alignfalsetruejava.lang.String

The alignment option for this image.

altfalsetruejava.lang.String

The alternate text for this image.

altKeyfalsetruejava.lang.String

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

borderfalsetruejava.lang.String

The width (in pixels) of the border around this image.

bundlefalsetruejava.lang.String

The servlet context attribute key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet.

dirfalsetruejava.lang.String

The direction for weak/neutral text for this element.

Since:
Struts 1.3.6
disabledfalsetruebooleanSet to true if this input field should be disabled.
indexedfalsetruebooleanValid 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.
langfalsetruejava.lang.String

The language code for this element.

Since:
Struts 1.3.6
localefalsetruejava.lang.String

The session attribute key for the Locale used to select internationalized messages. If not specified, defaults to the Struts standard value.

modulefalsetruejava.lang.String

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

onblurfalsetruejava.lang.StringJavaScript event handler executed when this element loses input focus.
onchangefalsetruejava.lang.StringJavaScript event handler executed when this element loses input focus and its value has changed.
onclickfalsetruejava.lang.StringJavaScript event handler executed when this element receives a mouse click.
ondblclickfalsetruejava.lang.StringJavaScript event handler executed when this element receives a mouse double click.
onfocusfalsetruejava.lang.StringJavaScript event handler executed when this element receives input focus.
onkeydownfalsetruejava.lang.StringJavaScript event handler executed when this element has focus and a key is depressed.
onkeypressfalsetruejava.lang.StringJavaScript event handler executed when this element has focus and a key is depressed and released.
onkeyupfalsetruejava.lang.StringJavaScript event handler executed when this element has focus and a key is released.
onmousedownfalsetruejava.lang.StringJavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed.
onmousemovefalsetruejava.lang.StringJavaScript event handler executed when this element is under the mouse pointer and the pointer is moved.
onmouseoutfalsetruejava.lang.StringJavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element.
onmouseoverfalsetruejava.lang.StringJavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element.
onmouseupfalsetruejava.lang.StringJavaScript event handler executed when this element is under the mouse pointer and a mouse button is released.
pagefalsetruejava.lang.String

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

pageKeyfalsetruejava.lang.String

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

propertyfalsetruejava.lang.String

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="").

srcfalsetruejava.lang.String

The source URL of the image for this input tag.

srcKeyfalsetruejava.lang.String

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

stylefalsetruejava.lang.StringCSS styles to be applied to this HTML element.
styleClassfalsetruejava.lang.StringCSS stylesheet class to be applied to this HTML element (renders a "class" attribute).
styleIdfalsetruejava.lang.StringIdentifier to be assigned to this HTML element (renders an "id" attribute).
tabindexfalsetruejava.lang.StringThe tab order (ascending positive integers) for this element.
titlefalsetruejava.lang.String

The advisory title for this element.

titleKeyfalsetruejava.lang.String

The message resources key for the advisory title for this element.

valuefalsetruejava.lang.String

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


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.