Overview | Library | Tag | Help
| FRAMES NO FRAMES

## h
Tag graphicImage

Renders an HTML "img" element. Render the clientId as the value of the "id" attribute.

Handling the Value

If the "name" attribute is present, execute algorithm Common Algorithm for Obtaining A Resource to Render to obtain a `Resource` instance. Call `Resource.getRequestPath()` and output the result as the value of the "src" attribute on the rendered markup.

Otherwise, if the "url" attribute is present, treat its value as if it was the value of the "value" attribute. Otherwise, if the "value" attribute is present, render the value of the component as the value of the "src" attribute, after passing it to the `getResourceURL()` method of the `ViewHandler` for this application, and passing the result through the `encodeResourceURL()` method of the `ExternalContext`.

When handling the "src" attribute, the value must not be escaped. For example, `&` must not be turned into `&amp;`. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute.

Tag Information
Tag Class | com.sun.faces.taglib.html_basic.GraphicImageTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
id | false | true | `java.lang.String` | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
rendered | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.
url | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Context-relative URL to retrieve the resource associated with this component. This is an alias for the "value" property.
value | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | The current value of this component.
alt | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Alternate textual description of the element rendered by this component.
dir | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
height | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Override for the height of this image.
ismap | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating that this image is to be used as a server side image map. Such an image must be enclosed within a hyperlink ("a"). A value of false causes no attribute to be rendered, while a value of true causes the attribute to be rendered as ismap="ismap".
lang | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Code describing the language used in the generated markup for this component.
library | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The libraryName for this resource.
longdesc | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | URI to a long description of the image represented by this element.
name | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The resourceName for this resource.
onclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is clicked over this element.
ondblclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is double clicked over this element.
onkeydown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is pressed down over this element.
onkeypress | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is pressed and released over this element.
onkeyup | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is released over this element.
onmousedown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is pressed down over this element.
onmousemove | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved within this element.
onmouseout | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved away from this element.
onmouseover | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved onto this element.
onmouseup | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is released over this element.
style | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) to be applied when this component is rendered.
styleClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
title | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Advisory title information about markup elements generated for this component.
usemap | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The name of a client side image map (an HTML "map" element) for which this element provides the image.
width | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Override for the width of this image.
binding | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`) | The ValueExpression linking this component to a property in a backing bean

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

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.