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.
partialTriggersfalsefalsejava.lang.StringThis attribute is meaningful only when the component is used inside an Apache MyFaces Trinidad application.

The IDs of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too.

Separate multiple triggers with a space.

Trigger identifiers are relative to the source component for non-NamingContainer components and relative to the parent component for NamingContainer components. Identifiers must account for NamingContainers. You can use a single colon to start the search from the root, or use multiple colons to move up through the NamingContainer. For example, for a non-NamingContainer component, "::" will search from the parent naming container, ":::" will search from the grandparent naming container, etc. For a NamingContainer component, "::" will search from the parent component's parent naming container. ":::" will search from the parent component's grandparent naming container.

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.
baseTextDirectionfalsefalsejava.lang.StringThis attribute controls the direction of the text. supported values: LTR, RTL , Contextual

Variables
No Variables Defined.


© Copyright Rogue Wave Software Inc. 1997, 2018. All Rights Reserved.