support (RichFaces JSF components library Tag library documentation)
Keywords: $title

Overview | Library | Tag | Help
| FRAMES NO FRAMES

## Ajax4jsf ( Legacy URL )
Tag support

Adds the AJAX functionality for those UIComponent-based component that have properties for JavaScript events. During Decoding: If a request is Ajax-performed, obtains the Map from the "requestParameterMap" property of the ExternalContext. If this Map contains non null value for the "clientId" key, creates a javax.faces.event.ActionEvent around the component, passes it to the queueEvent() method of the component, and then appends it's reRender components IDs to a list of rendered areas. During Encoding. Doesn't encode as a component. Instead, it adds ValueBinding for a property of the parent component with the name as a value of its "event" property. As a result, when rendered, the parent component builds JavaScript code for submitting an AJAX request on this event. If the component has child UIParameter components, appends it's name/value as additional request parameters. If a parent component is an instance of UIInput and the ajaxType property is "input", submits the value of the input field, also. In this case, you can submit a single input field outside of UIForm.

Tag Information
Tag Class | org.ajax4jsf.taglib.html.jsp.AjaxSupport
TagExtraInfo Class | None
Body Content | JSP
Display Name | Ajax Support

Attributes
Name | Required | Request-time | Type | Description
actionListener | false | false | `java.lang.String` | MethodBinding pointing at method accepting an ActionEvent with return type void
oncomplete | false | false | `java.lang.String` | JavaScript code for call after request completed on client side
rendered | false | false | `java.lang.String` | If "false", this component is not rendered
reRender | false | false | `java.lang.String` | Id['s] (in format of call UIComponent.findComponent()) of components, rendered in case of AjaxRequest caused by this component. Can be single id, comma-separated list of Id's, or EL Expression with array or Collection
focus | false | false | `java.lang.String` | id of element to set focus after request completed on client side
id | false | false | `java.lang.String` | Every component may have a unique id that is automatically created if omitted
disableDefault | false | false | `java.lang.String` | Disable default action for target event ( append "return false;" to javascript )
bypassUpdates | false | false | `java.lang.String` | If "true", after process validations phase it skips updates of model beans on a force render response. It can be used for validating components input
limitToList | false | false | `java.lang.String` | If "true", updates on client side ONLY elements from this 'reRender' property. If "false" (default) updates all rendered by ajax region components
ajaxSingle | false | false | `java.lang.String` | if "true", submits ONLY one field/link, instead of all form controls
onsubmit | false | false | `java.lang.String` | JavaScript code for call before submission of ajax event
action | false | false | `java.lang.String` | MethodBinding pointing at the application action to be invoked, if this UIComponent is activated by the user, during the Apply Request Values or Invoke Application phase of the request processing lifecycle, depending on the value of the immediate property
timeout | false | false | `java.lang.String` | Timeout (in ms) for request
actionExpression | false | false | `java.lang.String` | The action method binding expression.
status | false | false | `java.lang.String` | ID (in format of call UIComponent.findComponent()) of Request status component
requestDelay | false | false | `java.lang.String` | Attribute defines the time (in ms.) that the request will be wait in the queue before it is ready to send. When the delay time is over, the request will be sent to the server or removed if the newest 'similar' request is in a queue already
eventsQueue | false | false | `java.lang.String` | Name of requests queue to avoid send next request before complete other from same event. Can be used to reduce number of requests of frequently events (key press, mouse move etc.)
immediate | false | false | `java.lang.String` | True means, that the default ActionListener should be executed immediately (i.e. during Apply Request Values phase of the request processing lifecycle), rather than waiting until the Invoke Application phase
data | false | false | `java.lang.String` | Serialized (on default with JSON) data passed on the client by a developer on AJAX request. It's accessible via "data.foo" syntax
event | false | false | `java.lang.String` | Name of JavaScript event property ( onclick, onchange, etc.) of parent component, for which we will build AJAX submission code
onbeforedomupdate | false | false | `java.lang.String` | JavaScript code for call before DOM has been updated on client side
binding | false | false | `java.lang.String` | The attribute takes a value-binding expression for a component property of a backing bean
ignoreDupResponses | false | false | `java.lang.String` | Attribute allows to ignore an Ajax Response produced by a request if the newest 'similar' request is in a queue already. ignoreDupResponses="true" does not cancel the request while it is processed on the server, but just allows to avoid unnecessary updates on the client side if the response isn't actual now

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.