3.3. Facelets Support

RichFaces has high-level support for Facelets, regardless of the version used. However, some JSF frameworks (including Faces) require that their own ViewHandler be listed first in the ViewHandler chain. RichFaces also requires that its AjaxViewHandler be listed first, but because it is installed first, no settings will need to be altered. Where multiple frameworks are used without RichFaces, you can use the VIEW_HANDLERS parameter to define the order in which the ViewHandlers are used. For example:

...
<context-param>
     <param-name>org.ajax4jsf.VIEW_HANDLERS</param-name>
     <param-value>com.sun.facelets.FaceletViewHandler</param-value>
</context-param>
...

...
<context-param>
     <param-name>org.ajax4jsf.VIEW_HANDLERS</param-name>
     <param-value>com.sun.facelets.FaceletViewHandler</param-value>
</context-param>
...

This declares that while Facelets will officially be first, AjaxViewHandler will briefly be ahead of it to perform some small, important task.