PhotoAlbum Application Download Support Developer Guide
Resources/Beans Handling
Ajax Miscellaneous
Tag Information

a4j:include functionality is equal to the facelets ui:include functionality, plus, it enables the partial page navigation in an Ajax mode. The standard JSF navigation rules are used to define the navigation between the view.

viewId attribute specifies the view id of a page that will be included. It should be a full context-relative path of the resource in order to use as from-view and to-view in the JSF navigation cases.

Include example

The demo shows the example of three-steps wizard created using a4j:include. The navigation rules defined in the faces-config.xml are used to navigate between the steps of the wizard.

Using a4j:include for Wizard-like behaviour
First Name:
Last Name:

View Source

View wstep1.xhtml Source

View wstep2.xhtml Source

View finalStep.xhtml Source

View faces-config.xml Navigation Rules

The Ajax command component (button, link, jsFunction, etc) should be located inside the a4j:include in order to have a partial navigation. When the navigation is performed, a part of the component tree content is replaced with the content of a view given by a navigation rule.

The content of the a4j:include is not isolated from the whole view. You can point to the other parts of the view with reRender if you want to update them while you navigate inside the a4j:include.

RichFaces Wiki RichFaces Project Site