Tag GraphicImage (JSF 2.0)

Monday, 09 April 2012 15:01

Tag GraphicImage with JSF 2.0

GraphicImage tag displays image on the page.�It renders an html "img" element. This tag renders the image file stored in the location specified in the "value" attribute of "graphicImage" tag.

Value Handling

If the "name" attribute is present, it executes 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 &. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute.

Using resource library with JSF 2.0

In JSF 2.0, all your resources files like css , images or JavaScript , should be located into a �resources� folder in the root of your web application (same folder level as �WEB-INF� folder).

In the following example :

 
<h:graphicImage library="images" name="mylogo.png" />

The image "mylogo.png" should be located in :

+web_app root
   +resources
      +images
         +mylogo.png 

Tag Information

GraphicImage Attributes