event (Jakarta Server Faces 2.3.2 VDL Documentation)

Description:

Allow JSF page authors to install ComponentSystemEventListener instances on a component in a page.

Name Required Type Description

listener

true

javax.el.MethodExpression
(signature must match

public void
                listener(javax.faces.event.ComponentSystemEvent event) throws
                javax.faces.event.AbortProcessingException

)

The expression must evaluate to a public method that takes a ComponentSystemEvent parameter, with a return type of void, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing where the event came from, but this can be useful in cases where a notification is needed that "an event happened".

type

true

javax.el.ValueExpression
(must evaluate to java.lang.String)

Name of the event for which to install a listener. The following table lists the valid values for this attribute, and the corresponding event type for which the listener action is registered.

value for "`type`" tag attribute	Type of event sent to listener method
preRenderComponent	javax.faces.event.PreRenderComponentEvent
preRenderView	javax.faces.event.PreRenderViewEvent
postAddToView	javax.faces.event.PostAddToViewEvent
preValidate	javax.faces.event.PreValidateEvent
postValidate	javax.faces.event.PostValidateEvent

In addition to these values, the fully qualified class name of any java class that extends javax.faces.event.ComponentSystemEvent may be used as the value of the "type" attribute.

Also, the @javax.faces.event.NamedEvent annotation may be attached to any java class that extends javax.faces.event.ComponentSystemEvent. This enables that event to be referenced from this attribute, as descibed in the javadocs for @NamedEvent.

f

Tag event