Overview | Library | Tag | Help
| FRAMES NO FRAMES

## f
Tag setPropertyActionListener

Register an ActionListener instance on the UIComponent associated with the closest parent UIComponent custom action. This actionListener will cause the value given by the "value" attribute to be set into the ValueExpression given by the "target" attribute.

The implementation of this tag creates a special `ActionListener` instance and registers it on the `ActionSource` associated with our most immediate surrounding instance of a tag whose implementation class is a subclass of `UIComponentTag`. This tag creates no output to the page currently being created.

The `ActionListener` instance created and installed by this tag has the following behavior and contract.

- Only create and register the `ActionListener` instance the first time the component for this tag is created
- The "target" and "value" tag attributes are ValueExpression instances and are stored unevaluated as instance variables of the listener.
- When the listener executes, perform the following:
  Call getValue() on the "value" ValueExpression.
  If value of the "value" expression is null, call setValue() on the "target" ValueExpression with the null value.
  If the value of the "value" expression is not null, call getType() on the "value" and "target" ValueExpressions to determine their property types.
  Coerce the value of the "value" expression to the "target" expression value type following the Expression Language coercion rules. Call setValue() on the "target" ValueExpression with the resulting value.
  If either coercion or the execution of setValue() fails throw an AbortProcessingException.

Tag Information
Tag Class | com.sun.faces.taglib.jsf_core.SetPropertyActionListenerTag
TagExtraInfo Class | None
Body Content | empty
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
value | true | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | ValueExpression to be stored as the value of the target attribute.
target | true | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | ValueExpression that is the destination of the value attribute.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

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.