ajax (Jakarta Server Faces 2.3.2 VDL Documentation)

Description:
Register an AjaxBehavior instance on one or more UIComponents implementing the ClientBehaviorHolder interface. This tag may be nested witin a single component (enabling Ajax for a single component), or it may be "wrapped" around multiple components (enabling Ajax for many components).

The String value for ids specified for execute and render may be specified as a search expression as outlined in the JavaDocs for UIComponent.findComponent(). The implementation must resolve these ids as specified for UIComponent.findComponent(). For example, consider the following Facelets code.
<h:form id="form_1">

<h:panelGrid id="panel_1" rows="2">



</h:panelGrid>

</h:form>

<h:form id="form_2">

<h:commandButton id="button">

<f:ajax render=":form1:panel_1 panel_2" />

</h:commandButton>

<h:panelGrid id="panel_2">



</h:panelGrid>

</h:form>
When the button is pressed, panel_1, in form_1 will be re-rendered, along with panel_2 in form_2.

Attributes
Name	Required	Type	Description
`delay`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	If less than delay milliseconds elapses between calls to request() only the most recent one is sent and all other requests are discarded. If this option is not specified, or if the value of delay is the literal string `'none'` without the quotes, no delay is used.
`disabled`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	A value of "true" indicates the AjaxBehavior should not be rendered. A value of "false" indicates the AjaxBehavior should be rendered. "false" is the default.
`event`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	A String or ValueExpression (that evalulates to a String) identifying the type of event the Ajax action will apply to. If specified, it must be one of the events supported by the component the Ajax behavior is being applied to. For HTML components this would be the set of supported DOM events for the component, plus "action" for Faces ActionSource components and "valueChange" for Faces EditableValueHolder components. If not specified, the default event is determined for the component. The DOM event name is the actual DOM event name (for example: "click") as opposed to (for example: "onclick").
`execute`	`false`	`javax.el.ValueExpression` (must evaluate to `java.util.Collection`)	Evaluates to Collection<String>. This is a space separated list of search expressions to components that will participate in the "execute" portion of the Request Processing Lifecycle. See the javadoc for `SearchKeywordResolver` for the complete list of keywords. If a literal is specified the ids must be space delimited. If not specified, the default value of "@this" is assumed. For example, `@this clientIdOne clientIdTwo`.
`immediate`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	If "true" behavior events generated from this behavior are broadcast during Apply Request Values phase. Otherwise, the events will be broadcast during Invoke Aplications phase
`listener`	`false`	`javax.el.MethodExpression` (signature must match `public void processAjaxBehavior(javax.faces.event.AjaxBehaviorEvent event) throws javax.faces.event.AbortProcessingException`)	Method expression referencing a method that will be called when an AjaxBehaviorEvent has been broadcast for the listener.
`onerror`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	The name of the JavaScript function that will handle errors.
`onevent`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	The name of the JavaScript function that will handle UI events.
`render`	`false`	`javax.el.ValueExpression` (must evaluate to `java.util.Collection`)	Evaluates to Collection<String>. The search expressions to components that will participate in the "render" portion of the Request Processing Lifecycle. See the javadoc for `SearchKeywordResolver` for the complete list of keywords. If a literal is specified the identifiers must be space delimited. If not specified, the default value of "@none" is assumed. For example, `@this clientIdOne clientIdTwo`.
`resetValues`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Reset specific input values. Interpret the value of the `render` attribute as a space separated list of client identifiers suitable for passing directly to `UIViewRoot.resetValues()`. The implementation must cause an `ActionListener` to be attached to the `ActionSource` component in which this tag is nested that calls `UIViewRoot.resetValues()` passing the value of the `render` attribute as the argument.

f

Tag ajax