Create new RichFaces Documentation Jira issue

This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.orgCommunity Documentation

6.1.3.  < a4j:form > available since 3.0.0

expand all Description Details of Usage Reference Data Relevant Resources Links

The <a4j:form> component enhances functionality of the standard JSF <h:form> component with possibility of default Ajax submission and fixes the problem with <h:commandLink> generation inside the form.

Along with a4j:htmlCommandLink , <a4j:form> component fixes the problem of <h:commandLink> component that cannot be re-rendered without re-rendering the whole form it belongs to. For the further details see the Ajax Form Usage page at RichFaces Livedemo.

The <a4j:form> component adds extra functionality to non-Ajax action/command components: submission is performed via Ajax when "ajaxSubmit" attribute set to "true".

If the <a4j:form> component works in an Ajax mode, the standard Ajax attributes such as "reRender" , "limitToList" , "requestDelay" , etc. can be used.


<a4j:form ajaxSubmit="true" reRender="name">
        <h:commandButton value="Set Local Name to John (Ajax)" action="#{userBean.nameItJohn}" />
        <h:outputText id="name" value="Name:#{}" />

Here is a managed bean:


public class UserBean {
    private String name="";
    public String nameItJohn() {
        return null;
    public String getName() {
    public void setName(String name) { = name;

In the example above the ajaxSubmit="true", so all standard action components on this form become ajaxable. The "reRender" attribute contains an Id of component for re-rendering after an Ajax response.


If you have <h:commandButton> or <h:commandLink> inside a form, they work as <a4j:commandButton> .


You should not use <a4j:form> component with ajaxSubmit="true" if it contains other Ajax command components. Also, due to the security reason, file upload form element cannot be convertible to the be ajaxable.

Table of <a4j:form> attributes.

Visit Ajax Form page at RichFaces Livedemo for examples of component usage and their sources.

For additional information about attributes of this component read 'Ajax Attribute section.