From jbosstools-commits at lists.jboss.org Wed Jan 26 21:54:57 2011 Content-Type: multipart/mixed; boundary="===============5109709138856927585==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r28640 - trunk/jsf/docs/jsf_tools_ref_guide/en-US. Date: Wed, 26 Jan 2011 21:54:57 -0500 Message-ID: <201101270254.p0R2svU9007170@svn01.web.mwc.hst.phx2.redhat.com> --===============5109709138856927585== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: mcaspers Date: 2011-01-26 21:54:57 -0500 (Wed, 26 Jan 2011) New Revision: 28640 Modified: trunk/jsf/docs/jsf_tools_ref_guide/en-US/jsf_support.xml Log: General Updates Modified: trunk/jsf/docs/jsf_tools_ref_guide/en-US/jsf_support.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/jsf/docs/jsf_tools_ref_guide/en-US/jsf_support.xml 2011-01-27 02:= 37:53 UTC (rev 28639) +++ trunk/jsf/docs/jsf_tools_ref_guide/en-US/jsf_support.xml 2011-01-27 02:= 54:57 UTC (rev 28640) @@ -1,169 +1,148 @@ - - - - JBoss Developer Studio - Eclipse - JSF Tools - Java - JBoss - - + + + + JBoss Developer Studio + Eclipse + JSF Tools + Java + JBoss + + = - JavaServer Faces Support + JavaServer Faces Support = - We don't lock you into any one JavaServer - Faces implementation. You can always se= lect the one which is - necessary for you while , to - any existing Eclipse project or as well. - At this point the special wizard will prompt you to specify = a proper JSF environment. - It may be JSF 1.1.02 RI or JSF 1.2 which integrates a numb= er of new features and - changes. The wizard also lets you select JSF implementatio= n with a component - orientation such as JSF 1.2 with Facelets or MyFaces 1.1.4= . + + We don't lock you into any one JavaServer Faces implementation. You can always specify the desired Jav= aServer Faces implementation while creating a new JSF project= (see ), adding JSF capability to any ex= isting Eclipse project (see ) or impo= rting existing JSF projects (see ). + + + At this point the special wizard will prompt you to specify an appropria= te JSF environment. It may be JSF 1.1.02 RI, or JSF 1.2 which integrates a = number of new features and changes. The wizard also lets you select JSF imp= lementation with a component orientation such as JSF 1.2 with Facelets or M= yFaces 1.1.4. + = -
- Choosing JSF Environment - - - - - -
+
+ Choosing JSF Environment + + + + + +
= - After specifying a proper JSF environment all the required l= ibraries for the selected - version will be added to your project. + + After specifying an appropriate JSF environment all the required librari= es associated with the selected version will be added to your project. + = -
+
= - Facelets Support - In this section we will focus more on all concepts t= hat are integrated for - working with Facelets. + Facelets Support + In this section we will focus all the concepts that relate to work= ing with Facelets. = - The Facelets extends JavaServer Faces by providing a= lightweight framework - that radically simplifies the design of presentati= on pages for JSF. Facelets can be used in a variety of ways that we - will consider further in this section. + + Facelets extend JavaServer Faces by providing a lightweight framework t= hat radically simplifies the design of presentation pages for JSF. Facelets= can be used in a variety of ways that we will consider further in this sec= tion. + = -
- Facelets templates - If you want to build an application using Fa= celets, just create a - project with Facelets based on version 1.2= of the JSF Reference - Implementation, i. e. select the - JSF 1.2 with Facelets - in the JSF Environment section= of the New JSF Project - wizard. +
+ Facelets templates + + If you want to build an application using Facelets, create a project w= ith 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. + = -
- Choosing Facelets Environment</titl= e> - <mediaobject> - <imageobject> - <imagedata - fileref=3D"images/jsf_su= pport/jsf_support_2.png" - /> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Choosing Facelets Environment + + + + + +
= - Once you've selected the environment, i= t's possible - to specify the one of three available temp= lates: -
- Choosing Facelets Template - - - - - -
- The following table lists possible templates= with Facelets for any JSF - project and gives a proper description for= each one. - - Facelets Templates - - - + Once you have selected the environment, it is possible to specify= one of three available templates: +
+ Choosing Facelets Template + + + + + +
+ The following table lists the templates that can be used with Fac= elets for any JSF project, and gives a detailed description for each one. +
+ Facelets Templates + + + = = - - - - Template - + + + + Template + = - - Description - - - + + Description + + + = - + = - - - - - FaceletsBlankW= ithoutLibs - - - + + + + + FaceletsBlankWithoutLibs + + + = - - Some servers alrea= dy provide - jsf libs and you take ri= sk - of getting conflicting - libraries while deploying - your project. To avoid s= uch - conflicts, use a template - without libs if you have= a - server with its own jsf - libraries - - + + + Some servers already provide JSF libs and you risk library confli= cts while deploying your project. To avoid such conflicts, use a template w= ithout libs if you have a server with its own JSF libraries. + + + = - - - - - FaceletsKickSt= artWithRILibs - - - + + + + + FaceletsKickStartWithRILibs + + + = - - A sample applicati= on with - Facelets that is ready to - run - - + + + A sample application with Facelets that is ready to run. + + = - - - - - FaceletsKickSt= artWithoutLibs - - - + + + + + FaceletsKickStartWithoutLibs + + + = - - A sample applicati= on without - libraries - - + + A sample application without libraries. + + = - - -
-
-
- Facelets components + + + +
+
+ Facelets components = - The JBoss Tools - Palette comes with the Facelets co= mponents ready to - use. A useful tip appears when you hover t= he mouse cursor over the - tag, the tip includes a detailed descripti= on of the tag component, - the syntax and available attributes. + + The JBoss Tools Palette comes with the Facelets components ready to us= e. 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 av= ailable attributes. + = -
- Facelets Components - - - - - -
-
-
- Code assist for Facelets +
+ Facelets Components + + + + + +
+
+
+ Code assist for Facelets = - One more feature which comes with Facelets s= upport is code assist - (Ctrl + Space). It is available for Facelets - tags while editing - .xhtml - files. + + JSF Tools provides Facelets code assistance, which can be assessed by = pressing CtrlSpace. = It is available for Facelets tags while editing .xhtml files. + = -
- XHTML File Code Assist - - - - - -
+
+ XHTML File Code Assist + + + + + +
= - What's more, code assist is also availa= ble for - "jsfc" - attribute in any HTML tag. + + Code assist is also available for jsfc attributes in any = HTML tag. + = -
- Code Assist for JSFC Attribute</tit= le> - <mediaobject> - <imageobject> - <imagedata - fileref=3D"images/jsf_su= pport/jsf_support_6.png" - scale=3D"70"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Code Assist for JSFC Attribute + + + + + +
= - After selecting - "jsfc" - you get the code assist for JS= F components available on - a page. + After selecting an jsfc attribute, the code assist f= eature will list the JSF components available on a page. = -
- Code Assist for JSF Components</tit= le> - <mediaobject> - <imageobject> - <imagedata - fileref=3D"images/jsf_su= pport/jsf_support_7.png" - scale=3D"80"/> - </imageobject> - </mediaobject> - </figure> + <figure> + <title>Code Assist for JSF Components + + + + + +
= - When a component is chosen you will see all = available attributes for - it. + When a component is selected you will see all available attribute= s for it. = -
- Available Attributes for the Compon= ent - - - - - -
-
-
- Open On feature - Finally, Eclipse's - OpenOn - feature for editing Facelets f= iles is supported. Using this feature, - you can easily navigate between the Facelets - templates and other parts of yo= ur projects. Just by - holding down the Control key while hoverin= g the mouse cursor over a - reference to a template, the reference bec= omes a hyperlink to open - that template. +
+ Available Attributes for the Component + + + + + +
+
+
+ Open On feature + + Finally, JSF Tools supports Eclipse's OpenOn feature while editing Facelets files. Using this feature, you can ea= sily navigate between the Facelets templates and other= parts of your projects. By holding down the Ctrl key whil= e hovering the mouse cursor over a reference to a template, the reference b= ecomes a hyperlink to navigate to that template. + = +
+ Template Hyperlink + + + + + +
= -
- Template Hyperlink - - - - - -
- -
+
= -
+
= = = --===============5109709138856927585==--