Supporting Facelets and Trinidad

If you want to use JViews Framework JSF components in a Facelets context, your Web application must be correctly configured.

To make JViews Framework JSF components compatible with Facelets and Trinidad:

To see examples of correct settings for Facelets with Trinidad, look at the faces-config.xml and web.xml files. If you want to use Facelets without Trinidad, look at faces-config-std.xml and web-std.xml instead.

Develop XHTML-based pages according to the tag library documentation.

All attributes and all tags except the menu tags listed in Contextual menus are supported in Facelets.

If you are using custom tags, make sure you provide a custom.taglib.xml file that describes your custom library and declare its XML namespace in the page.

Make sure that your .war files (or your server default libraries) include the necessary Facelets (and possibly Trinidad) jar files.

If you want to run against JSF 1.1 or 1.2: classpath=jviews-jsf1-facelets-support.jar; jviews-xxx-all.jar; <JSF1.1 or JSF1.2 jars>

If you want to run against JSF 2.0: classpath=jviews-jsf2-facelets-support.jar; jviews-xxx-all.jar; <JSF2.0 jars>

For complete JViews Maps application examples configured for use with Facelets or Trinidad, see <install-dir> /jviews-maps90/codefragments/jsf-maps-facelets/webpages/index.xhtml.

In a facelets context, you can provide dynamic menus through the factory or factoryClass attribute of a contextual menu object.

<... contextualMenu ... factoryClass="mydemo.somepackage.MenuFactory" />

At the JViews Framework level, the contextual menu element is contextualMenu.

You can use the value attribute of the contextual menu element to bind a static menu (running the code of the factory only once).

<... contextualMenu ... value="#{chartBean.menu}" />

In addition, you can use menu, menuItem, or menuSeparator tag components directly in the page:

<jvf:contextualMenu itemStyleClass="menuItem"

itemHighlightedStyleClass="menuItemHighlighted"

itemDisabledStyleClass="menuItemDisabled">

<jv:menuItem label="menuItem 1" onclick="alert('menuItem 1')" />

<jv:menuItem label="menuItem 2" onclick="alert('menuItem 2')" />

<jv:menuItem label="menuItem 3" onclick="alert('menuItem 3')" />