viewAction (Jakarta Server Faces 3.0.0 VDL Documentation)

All Tags

Description:

This action component specifies an application-specific command (or action), using an EL method expression, to be invoked during one of the Faces lifecycle phases, by default Invoke Application.

Component Information
Info	Value
Component Type	`jakarta.faces.ViewAction`
Handler Class	None
Renderer Type	None
Description	None

Attributes
Name	Required	Type	Description
`action`	`true`	`jakarta.el.MethodExpression` (signature must match `public java.lang.Object action()`)	MethodExpression representing the application action to invoke when this component is activated by the user. The expression must evaluate to a public method that takes no parameters, and returns an Object (the toString() of which is called to derive the logical outcome) which is passed to the NavigationHandler for this application.
`actionListener`	`false`	`jakarta.el.MethodExpression` (signature must match `public void actionListener(jakarta.faces.event.ActionEvent)`)	MethodExpression representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent 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 "some action happened".
`immediate`	`false`	`jakarta.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase.
`onPostback`	`false`	`jakarta.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	View actions are most commonly used on the initial view request. Therefore, view actions do not operate on postback, by default. This attribute enables a view action to operate on postback.
`phase`	`false`	`jakarta.el.ValueExpression` (must evaluate to `java.lang.String`)	Specifies the phase in which the action invocation should occur using the name of the phase constant in the PhaseId class (the case does not matter). The value must be one of APPLY_REQUEST_VALUES, PROCESS_VALIDATIONS, UPDATE_MODEL_VALUES, or INVOKE_APPLICATION. The default is INVOKE_APPLICATION.
`rendered`	`false`	`jakarta.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Like all children of , a view action has no visual representation in the view. This attribute has exactly the same effect on a view action as the rendered attribute has on a visual component. Specifically, if the value of this attribute evaluates to false the component has no effect.

All Tags