JViews Core
Tag imageButton


Image Button Faces Component

The image button faces component allows you to create a button and associate an action to be executed once it is clicked. The button can display different images for its 3 different states: normal, highlighted, and selected. Additionally you can set the tooltip for the button using its title attribute.

Usage

<jv:imageButton
    id="showDetailsButton"
    title="Show Details"
    style="width:20px; height:20px;"
    image="images/show-details-button-normal-image.gif"
    selectedImage="images/show-details-button-selected-image.gif"
    rolloverImage="images/show-details-button-highlighted-image.gif"
    onclick="alert('Here are the details...');" />

DHTML - JavaScript Types

IlvImageButtonProxy

JSF Component Class

IlvDHTMLImageButton



Tag Information
Tag Classilog.views.faces.dhtml.taglib.IlvImageButtonTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameImage Button

Attributes
NameRequiredRequest-timeTypeDescription
actionfalsefalsejava.lang.StringThe method binding reference or a constant outcome executed if this button is a submit button and if the user selects it.
actionListenerfalsefalsejava.lang.StringThe method binding reference executed if this button is a submit button and if the user selects it.
bindingfalsefalsejava.lang.StringThe value binding expression linking this component to a property in a backing bean. If this attribute is set, the tag does not create the component itself but retrieves it from the bean property. This attribute must be a value binding.
buttonGroupIdfalsefalsejava.lang.StringThe identifier of the button group. In a button group, one button can be selected at a time.
cursorfalsefalsejava.lang.StringThe cursor displayed when the mouse is on the button.
doActionOnBGDeselectfalsefalsejava.lang.StringWhether the button should execute its action when it's deselected by its button group. It's happening when another button of the button group is selected. In this case the action is called with an empty event. Default value is false.
enabledfalsefalsejava.lang.StringThe enabled state of the button. Default value is true.
idfalsefalsejava.lang.StringThe ID of this component.
imagefalsefalsejava.lang.StringThe image representing the button in its 'normal state'.
immediatefalsefalsejava.lang.StringThe immediate property of a command.
messagefalsefalsejava.lang.StringThe message displayed on the status bar when the mouse is on the button.
messageBoxfalsefalsejava.lang.StringThe binding to a message box component used to display messages.
messageBoxIdfalsefalsejava.lang.StringThe ID of a message box component used to display messages.
onclickfalsefalsejava.lang.StringThe JavaScript action executed when the button is clicked. The action can use 'thisObj' and 'thisEvent' parameters when available that respectively represent the DIV object that contains the button and the event that launches this action.
rolloverImagefalsefalsejava.lang.StringThe image representing the button when the mouse is over the button.
selectedfalsefalsejava.lang.StringThe selection state of the button. Default value is false
selectedImagefalsefalsejava.lang.StringThe image representing the button when the button is selected.
stylefalsefalsejava.lang.StringCSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.lang.StringSpace separated list of CSS style classe(s) to be applied when this element is rendered.
titlefalsefalsejava.lang.StringThe tooltip message.
togglefalsefalsejava.lang.StringThe toggle state of the button. Default value is false
typefalsefalsejava.lang.StringThe type of the button. Valid values are submit or button.
  • A submit button will submit its enclosing form.
  • A button button only executes the JavaScript onclick action.

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.   Documentation homepage.