JSF Tools does not lock you into any one JavaServer Faces implementation. You can always specify the desired JavaServer Faces implementation while creating a new JSF project (see Section 3.1, “Creating a New JSF Project”), adding JSF capability to any existing Eclipse project (see Section 3.3, “Adding JSF Capability to Any Existing Project”), or importing existing JSF projects (see Section 3.2, “Importing Existing JSF Projects with Any Structure”).

At this point the special wizard will prompt you to specify an appropriate JSF environment. It may be JSF 1.1.02 RI, JSF 1.2, JSF 2.0 or JSF 2.1. The wizard also lets you select JSF implementation with a component orientation such as JSF 1.2 with Facelets or MyFaces 1.1.4.

Figure 2.1. Choosing JSF Environment

2.1. Facelets Support

In this section we will focus all the concepts that relate to working with Facelets.

Facelets extend JavaServer Faces by providing a lightweight framework that radically simplifies the design of JSF presentation pages. Facelets can be used in a variety of ways that we will consider further in this section.

2.1.1. Creating a JSF project with Facelets

If you want to build an application using Facelets, create a project with Facelets based on version 1.2 of the JSF Reference Implementation, i. e. select the JSF 1.2 with Facelets option in the JSF Environment section of the New JSF Project wizard.

Figure 2.2. Choosing Facelets Environment

Once you have selected the environment, it is possible to specify one of three available templates:

Figure 2.3. Choosing Facelets Template

The following table lists the templates that can be used with Facelets for any JSF project, and gives a detailed description for each one.

Table 2.1. Facelets Templates

Template	Description
FaceletsBlankWithoutLibs	Some servers already provide JSF libs and you risk library conflicts while deploying your project. To avoid such conflicts, use a template without libs if you have a server with its own JSF libraries.
FaceletsKickStartWithRILibs	A sample application with Facelets that is ready to run.
FaceletsKickStartWithoutLibs	A sample application without libraries.

2.1.2. Facelets components

The JBoss Tools Palette comes with the Facelets components ready to use. A useful tip appears when you hover the mouse cursor over the tag; this tip includes a detailed description of the tag component, the syntax and available attributes.

Figure 2.4. Facelets Components

2.1.3. Code assist for Facelets

JSF Tools provides Facelets code assistance, which can be accessed by pressing Ctrl+Space. It is available for Facelets tags while editing .xhtml files.

Figure 2.5. XHTML File Code Assist

Code assist is also available for jsfc attributes in any HTML tag.

Figure 2.6. Code Assist for JSFC Attribute

After selecting an jsfc attribute, the code assist feature will list the JSF components available on a page.

Figure 2.7. Code Assist for JSF Components

When a component is selected you will see all available attributes for it.

Figure 2.8. Available Attributes for the Component

2.1.4. Open On feature

Finally, JSF Tools supports Eclipse's OpenOn™ feature while editing Facelets files. Using this feature, you can easily navigate between the Facelets templates and other parts of your projects. By holding down the Ctrl key while hovering the mouse cursor over a reference to a template, the reference becomes a hyperlink to navigate to that template.

Figure 2.9. Template Hyperlink