org.apache.myfaces.custom.jslistener
Class AbstractJsValueChangeListener

java.lang.Object
  javax.faces.component.UIComponent
      javax.faces.component.UIComponentBase
          org.apache.myfaces.custom.jslistener.AbstractJsValueChangeListener

All Implemented Interfaces:

javax.faces.component.StateHolder

public abstract class AbstractJsValueChangeListener
extends javax.faces.component.UIComponentBase

Value change listener on client side.

This component replicates the 'Value Change Listener' functionality on the client side. It can be used when the user would like a change in the value of one control to trigger off changes in the states of other controls. One or more Javascript Listeners can be nested within the source control (a control belonging to the 'javax.faces.Input' family). When the value of the source control is modified, the listeners are triggered and the states of the target controls modified.

Unless otherwise specified, all attributes accept static values or EL expressions.

Since:

1.1.7

Version:

$Revision: 691856 $ $Date: 2008-09-03 21:40:30 -0500 (Wed, 03 Sep 2008) $

Author:

Martin Marinschek (latest modification by $Author: lu4242 $)

Field Summary

static String	COMPONENT_FAMILY
static String	COMPONENT_TYPE

Constructor Summary

AbstractJsValueChangeListener()

Method Summary

abstract String	getBodyTagEvent() Events are triggered by the 'onchange' event of the source control.
abstract String	getExpressionValue() the javascript expression to evaluate.
abstract String	getFor() for - the id of the target control
abstract String	getProperty() The result of the evaluated expression is assigned to the specified property of the target control

Methods inherited from class javax.faces.component.UIComponentBase

addFacesListener, broadcast, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacesContext, getFacesListeners, getFacet, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding

Methods inherited from class javax.faces.component.UIComponent

getFamily

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COMPONENT_TYPE

public static final String COMPONENT_TYPE

See Also:

Constant Field Values

COMPONENT_FAMILY

public static final String COMPONENT_FAMILY

See Also:

Constant Field Values

Constructor Detail

AbstractJsValueChangeListener

public AbstractJsValueChangeListener()

Method Detail

getFor

public abstract String getFor()

for - the id of the target control

getExpressionValue

public abstract String getExpressionValue()

the javascript expression to evaluate. The keyword '$srcElem' resolves to the source control and the keyword '$destElem' resolves to the target control

getProperty

public abstract String getProperty()

The result of the evaluated expression is assigned to the specified property of the target control

getBodyTagEvent

public abstract String getBodyTagEvent()

Events are triggered by the 'onchange' event of the source control. Here, an additional event can be specified (onload?). If specified this JavaScript event will be inserted in the body tag. JavaScript code will be the same like it is rendered in the parent component.