Class AbstractJsValueChangeListener

  extended by javax.faces.component.UIComponent
      extended by javax.faces.component.UIComponentBase
          extended by org.apache.myfaces.custom.jslistener.AbstractJsValueChangeListener
All Implemented Interfaces:
Direct Known Subclasses:

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.

$Revision: 691856 $ $Date: 2008-09-03 21:40:30 -0500 (Wed, 03 Sep 2008) $
Martin Marinschek (latest modification by $Author: lu4242 $)

Field Summary
static java.lang.String COMPONENT_FAMILY
static java.lang.String COMPONENT_TYPE
Fields inherited from class javax.faces.component.UIComponent
Constructor Summary
Method Summary
abstract  java.lang.String getBodyTagEvent()
          Events are triggered by the 'onchange' event of the source control.
abstract  java.lang.String getExpressionValue()
          the javascript expression to evaluate.
abstract  java.lang.String getFor()
          for - the id of the target control
abstract  java.lang.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, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, 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
encodeAll, getContainerClientId, getFamily, getValueExpression, setValueExpression
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail


public static final java.lang.String COMPONENT_TYPE
See Also:
Constant Field Values


public static final java.lang.String COMPONENT_FAMILY
See Also:
Constant Field Values
Constructor Detail


public AbstractJsValueChangeListener()
Method Detail


public abstract java.lang.String getFor()
for - the id of the target control


public abstract java.lang.String getExpressionValue()
the javascript expression to evaluate. The keyword '$srcElem' resolves to the source control and the keyword '$destElem' resolves to the target control


public abstract java.lang.String getProperty()
The result of the evaluated expression is assigned to the specified property of the target control


public abstract java.lang.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.

Copyright © 2011 The Apache Software Foundation. All Rights Reserved.