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:

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 String COMPONENT_TYPE
Constructor Summary
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
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail


public static final String COMPONENT_TYPE
See Also:
Constant Field Values


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


public AbstractJsValueChangeListener()
Method Detail


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


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


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


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.

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