From jbosstools-commits at lists.jboss.org Tue Jan 15 09:00:35 2008 Content-Type: multipart/mixed; boundary="===============2577041724047639661==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r5684 - in trunk/jsf/docs/userguide/en: modules and 1 other directory. Date: Tue, 15 Jan 2008 09:00:34 -0500 Message-ID: --===============2577041724047639661== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: ykryvinchanka Date: 2008-01-15 09:00:34 -0500 (Tue, 15 Jan 2008) New Revision: 5684 Removed: trunk/jsf/docs/userguide/en/modules/editors_features.xml trunk/jsf/docs/userguide/en/modules/more_editors.xml Modified: trunk/jsf/docs/userguide/en/images/more_editors/more_editors_44.png trunk/jsf/docs/userguide/en/images/more_editors/more_editors_45.png trunk/jsf/docs/userguide/en/modules/editors.xml Log: http://jira.jboss.com/jira/browse/JBDS-226 screens are retaken with 96 reso= lution + scale parameter is defined Modified: trunk/jsf/docs/userguide/en/images/more_editors/more_editors_44.p= ng =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 (Binary files differ) Modified: trunk/jsf/docs/userguide/en/images/more_editors/more_editors_45.p= ng =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 (Binary files differ) Modified: trunk/jsf/docs/userguide/en/modules/editors.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/userguide/en/modules/editors.xml 2008-01-15 13:00:44 UTC= (rev 5683) +++ trunk/jsf/docs/userguide/en/modules/editors.xml 2008-01-15 14:00:34 UTC= (rev 5684) @@ -1736,7 +1736,7 @@ Source Viewer - + Deleted: trunk/jsf/docs/userguide/en/modules/editors_features.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/userguide/en/modules/editors_features.xml 2008-01-15 13:= 00:44 UTC (rev 5683) +++ trunk/jsf/docs/userguide/en/modules/editors_features.xml 2008-01-15 14:= 00:34 UTC (rev 5684) @@ -1,593 +0,0 @@ - - - -Editors Features -JBoss Developer Studio has powerful editor features that help you ea= sily navigate within your application and make use of content and code assi= st no matter what project file (jsp, xhtml, xml, css, etc.) you are working= on. -
- -OpenOn - -OpenOn let's you easily navigate through y= our project without using the Package Explorer view (project tree). With Op= enOn, you can simply click on a reference to another file and that file wil= l be opened. - -OpenOn is available for the following files: - -XML files -JSP/XHTML Pages - Java files - -
- -XML Files - -Press and hold down the Ctrl key. As you move the mouse cursor over = different file references in = -the file, they display an underline. When you have the mouse cursor over t= he name of the file you want - to open, click and the file will open in its own editor. In this example = the managed bean NameBean will - open. -
-NameBean Managed Bean - = - - - - -
-This is the result of using OpenOn -
-NameBean Java Class - = - - - - -
-You can also try OpenOn with defined attributes. -
-OpenOn With Defined Attributes - = - - - - -
-You can also open any JSP pages. -
-JSP Page OpenOn - = - - - - -
-
-
- -JSP Pages - -OpenOn is also very useful in JSP pages. It wil= l allow you to quickly jump to the reference - instead of having to hunt around in the project structure. - -You can easily open the imported property files. -
-OpenOn With Imported Property Files - = - - - - -
-Use OpenOn to open a CSS file used with a JSP page: -
-OpenOn With CSS File - = - - - - -
-Open managed beans: -
-OpenOn With Maneaged Beans - = - - - - -
-For JSP files in a JSF project, you can also easily open the navigat= ion rules by applying OpenOn to the JSF tag for the na= vigation outcome: -
-OpenOn With JSF Tag - = - - - - -
-
-
- -
- -Code Assist and Dynamic Code Assist (based on project data) -
- -Content Assist Features -
- -Content Assist -Content assist is available when working with - - -Seam project files -JSF project files -Struts project files -JSP files - -
-
- -JSF Project Files - - When working with JSF project in JBoss Developer Studio, you can= use various Content Assist features while developing:= - -Content Assist for XML, JSP and JSF configuration files -Content Assist based on project data -Content Assist with graphical JSF editor - -
- -Content Assist for XML, JSP and JSF configuration files - - At any point when working with any XML, JSP and JSF configuratio= n files Content Assist is available to help you. Simply type Ctrl-Space to see what is available. - -Content Assist for JSF configuration file: -
-Content Assist in JSF Configuration File - = - - - - -
-Content Assist for JSF JSP file: -
-Content Assist in JSP File - = - - - - -
-Content Assist for other JSF XML project files (web.xml shown): -
-Content Assist in web.xml File - = - - - - -
-
-
- -Content Assist Based on Project Data - -JBoss Developer Studio takes Content Assist to the next level. Studi= o will - constantly scan your project and you will be able to insert code into the= JSP page from your project that - includes: - -Values from Property files -"Managed beans&qu= ot; attributes and methods -Navigation Rule Outcomes - JSF variables (context, request etc...) - -The first screenshot shows how to insert message from a Properties f= iles. You simply put the cursor - inside the "value" attribute and press Ctrl-Space= . JBoss Developer Studio will scan your project and show a list = of possible values to insert. -
-Inserting Message - = - - - - -
-In the following screen shot we are inserting a "Managed bean" attribute va= lue. Again, by simply clicking Ctrl-Space, JBoss Developer Studio will show a list of all possible values th= at you can insert: - -Once you select a Managed bean, it will show you a list of all avail= able attributes for the selected Managed bean (userBean). -
-Attributes List - = - - - - -
-Code Assist based on project data will also prompt you for navigatio= n rules that exist in your JSF - configuration file. -
-Code Assist - = - - - - -
-
-
- -Content Assist within Tree JSF Editor - -JBoss Developer Studio also provides Content Assist when working wit= hin the Tree JSF = -configuration editor. Just click Ctrl-Space= . -
-Content Assist in Tree JSF Configuration Editor - = - - - - -
-If a field contains right class name and you click a link near the f= ield you will come to the file with this class otherwise a new Java Class d= ialog will be shown: -
-New Java Class - = - - - - -
-If you entered an incorrect name in the field error markers will be = shown for field labels and tree items: -
-Error Markers - = - - - - -
- -To add a new property to a managed bean expand <= property>Managed Beans and select <name_of_bean> -Click Add button= in the Properties panel -In the dialog Add Property define a new property. From her= e also you can generate setters and getters methods: - -
-Create New Property - = - - - - -
-Here you can also add an additional navigation rule to the faces-con= fig.xml file. - -Select Navigation Rules -Click Add button= -In the dialog Add Rule define a view and give a name to the rule. Click Finish: - -
-Add New Navigation Rule - = - - - - -
- -
-
-
- -Struts Project Files -
- -Content Assist for Struts Configuration File -
-Struts Content Assist - = - - - - -
-
-
- -Content Assist for Struts JSP File -
-Struts JSP Content Assist - = - - - - -
-
-
-
- -JSP Pages -
- -Content Assist for JSF Tags -JBDS provides full code completion for JSF tags: - -
-JSF Tags Content Assist - = - - - - -
-When the tag is selected the required attributes, if there any, are = already inserted and the cursor is located to the first attribute. As this = point you can ask for attribute proposals. -
-Attributes Content Assist - = - - - - -
- -
-
- -Content Assist for JSTL Tags -
-JSTL Tags Content Assist - = - - - - -
-
-
- -Content Assist for HTML Tags -Content assist for HTML tags has the same mechanism as for JSF tags:= -
-HTML Tags Content Assist - = - - - - -
-You can use as well attributes proposals for HTML tags: -
-HTML Tags Content Assist - = - - - - -
-
-
- -Content Assist for JavaScript Tags -
-JavaScript Tags Content Assist - = - - - - -
-
- -
- -Content Assist within JSF Configuration Editor -
-Content Assist in JSF Configuration Editor - = - - - - -
-
-
-
- -Content Assist for Rich Faces components -JBDS indeed provides code completion for Rich Faces framework compon= ents. All you have to do is to install Rich Faces libraries into your proje= ct. See here how to install. -
-Content Assist for Rich Faces Components - = - - - - -
- - To insert a Rich Faces component on a page expand JBoss Rich Faces group on the palette = - Click on some component - Put the needed attributes in the Ins= ert Tag dialog and click Finish button -
-Insert Tag - = - - - - -
-
-
- The Rich Faces tag will be inserted on your page displayed in sourc= e and visual modes: -
-Rich Faces Component - = - - - - -
-
-
- -
- -Adding dynamic code assist to custom components that were added to = JBoss Tools Palette -Here is what you need to do to add project based code assist to a cu= stom component added in = -JBoss Developer Studio: - - Create a new xml file in <JBDS_= home>studio/eclipse/plugins/org.jboss.tools.common.kb_***/schemas/tld/. For example call it JeniaFaces.xml. The file should b= e written according to <JBDS_home>/studio/eclipse= /plugins/org.jboss.tools.common.kb/kb.jar/org/jboss/tools/common/kb/kb-sche= ma_1.0.dtd - - Here is how you set what is available for code assist: - -Adds code assist for JSF pre-defined objects, such as valu= e=3D"#{param}": - - - - -]]> - -Adds bundle resource (property file) code assist= : - - - - -]]> - -Adds managed bean property code assist: - - - - -]]> - -Adds managed bean property but with a specified type: - - - - - - -]]> - -Adds managed bean method with a signature: - - - - - - - - - -]]> - - Add information on your xml file in <JBDS_home>/studio/eclipse/plugins/org.jboss.common.kb_***/plug= in.xml = - - ]]> - - -Restart Eclipse. You should now have code assist for the c= omponent. - -
-
-
- -Full Control over Source Files - Synchronized Source and Visual Edi= ting - -JBoss Developer Studio offers the flexibility to edit any files in e= ither source or extra visual - modes at the same time. - -The project is yours and so is the source. JBoss Developer Studio pr= ovides you many different - graphical editors to speed your application development. At the same time= , you always have full control - over all project source files. Any changes you make in the source view, = will immediately appear in - the graphical view. - -The JSF configuration file editor has three views: Diagram, Tree and= Source. All views are = -synchronized, you can edit the file in any view. -
-Diagram View - = - - - - -
-
-Tree View - = - - - - -
- -
-Source View - = - - - - -
-The same applies to all other JBoss Developer Studio editors. - -Web XML editor is shown. Web XML editor has a graphical view (Tree) = and source (Source). - -
-Tree View - = - - - - -
-
-Source View - = - - - - -
-JBoss Developer Studio TLD file editor shown in Tree view. At any po= int you can edit the source by going - switching to Source view. -
-Tree Editor - = - - - - -
-
-Source Editor - = - - - - -
-The Struts configuration file editor has three views: Diagram, Tree = and Source. All views are synchronized, - you can edit the file in any view. -
-Struts Diagram View - = - - - - -
-Source view. Any changes here will immediately appear in all other v= iews. -
-Struts Source View - = - - - - -
-
-
\ No newline at end of file Deleted: trunk/jsf/docs/userguide/en/modules/more_editors.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/userguide/en/modules/more_editors.xml 2008-01-15 13:00:4= 4 UTC (rev 5683) +++ trunk/jsf/docs/userguide/en/modules/more_editors.xml 2008-01-15 14:00:3= 4 UTC (rev 5684) @@ -1,723 +0,0 @@ - - - -More Editors -Besides Visual Page Editor JBDS provides editors for editing project= files of any types: properties, TLD, web.xml, tiles, and so on. = -
- -Graphical Properties Editor - - The Properties editor allows you to work in= two different modes and also supports unicode characters. - - To create a new properties file, in the Package Explorer view, s= elect New > Properties File from = the right-click context menu on the folder where you want to create the fil= e. -
-Selecting Properties File - = - - - - -
- -You can edit the file using a table-oriented "Properties" = viewer: - -
-"Properties" Viewer - = - - - - -
- -You can also use a Source viewer for editing the file: -
-Source Viewer - = - - - - -
-
- -
- -Graphical TLD Editor - - The TLD editor comes with same features you= will find in all other JBoss Developer Studio editors: - - -Graphical and source edit modes -Validation and error checking - -
- -Tree view - -
-Tree View - = - - - - -
-
-
- -Source view - -You can easily switch from Tree to Source by selecting the Source ta= b at the bottom of the editor. - -
-Source View - = - - - - -
- -You can easily add a new tag: - -
-Adding a New Tag - = - - - - -
- -You can also easily add a new attribute to an e= xisting tag: -
-Adding a New Attribute - = - - - - -
-Content assist is available when editing the file using the Source v= iewer: - -
-Content Assist - = - - - - -
- -In the Source viewer, if at any point a tag is incorrect or incomple= te, an error will be indicated = -next to the line and also in the Problems view below. - -
-Error Reporting - = - - - - -
-
-
- -
- -Graphical Web Application File (web.xml) Editor - -The Web Application File editor comes with the same features you wil= l find in all other = -JBoss Developer Studio editors: - - -Graphical and source edit modes -Validation and error checking - -
-Tree View - -
-Tree View - = - - - - -
- -You can add any new elements right in the Tree viewer: - -
-Adding New Elements - = - - - - -
-
-
- -Source View - -Switch to the Source viewer to edit the web.xml= file by hand at any time: - -
-Source View - = - - - - -
-
-
- -Content Assist - -Content assist is available in the Source viewer. Simply click CTRL-Space anywhere in the file. - -
-Content Assist - = - - - - -
-
-
- -Errors Checking and Validation - -If errors occur anywhere in the file, small red dots will appear nex= t to the lines where the errors - occurred. Also, note that the file is marked by a small x in the Package = Explorer view. - -
-Errors Reporting - = - - - - -
-
-
-
- -Graphical Tiles Files Editor -
- -Graphical Editor For Tiles Files -The Tiles configuration file editor has three main viewers (modes): = Tree (shown), Diagram and Source. The modes can be selected via the tabs at= the bottom of the editor. Any changes made in one mode are immediately vis= ible when you switch to any other mode. - -When working in Source view, you always have all following features = available: - - -Content Assist -Open On Selection - -
-
- -Create New Tiles File - -To create a new Tiles files, right click any folder and select New > Tiles Files: - -
-Creating New Tiles File - = - - - - -
-
-
- -Tree View - -In the Tree mode, the different elements of the Tiles file are organ= ized into functional categories = -on the left-hand side and a form for editing the properties of currently s= elected items on the right-hand - side. - -
-Tree View - = - - - - -
-To edit the file, simply right click any node and select among the a= vailable actions: - -
-Editing in Tiles Editor - = - - - - -
-
-
- -Diagram View - -The Diagram mode is shown below: -
-Diagram View - = - - - - -
- -To create new definition, simply right click anywhere in the diagram= : -
-Creating New Definition - = - - - - -
- -You can also use the Diagram toolbar to make editing easier: - -
-Diagram Toolbar - = - - - - -
-
-
- -Source - - The Tiles editor also comes with a Source view that gives you full control over the source. = -Any changes here will immediately appear in when you switch to any of the = other viewers. -
-Source View - = - - - - -
- -Content assist is available in the Source mode. - -
-Content Assist - = - - - - -
- -Any errors are immediately reported as shown below: -
-Error Reporting - = - - - - -
- -You can also use the Outline view together with the editor's So= urce mode. Selecting any node in the Outline view will jump to that place i= n the source: - -
-Outline View - = - - - - -
-
-
- -
- -Graphical Editor for Struts Validation Files -JBoss Developer Studio comes with a visual validation editor. To cre= ate a new validation file, = -right click any folder and select File > Validation Fi= le from the context menu. - -
-Creating Validation File - = - - - - -
- -The validation editor works through a number of viewers. - -The Formsets viewer shows forms and their elements for which to defi= ne validation rules: - -
-Formsets Viewer - = - - - - -
- -The Constants viewer lets you set constant values for your validatio= n rules: - -
-Constants viewer - = - - - - -
- -The validation file also can be viewed in a Tree viewer: - -
-Tree Viewer - = - - - - -
- -At any point you have full control over the source by switching to t= he Source viewer. Any editing = -in this viewer will immediately be available in the other viewers of this = editor. - -
-Source Viewer - = - - - - -
- -You can also open your own custom or Struts-standard validation-rule= s.xml file. - -The Validators viewer shows the validation rules for a selected vali= dator. You can of course add your - own rules. - -
-Validation Rules - = - - - - -
- -Here are the validation rules shown in the Source viewer. - -
-Validation Rules in Source Viewer - = - - - - -
-
-
- -Spring IDE - JBoss Developer Studio bundles a Spring Framework edit= or from Spring IDE f= or Eclipse. Visit this site for the latest versions and documentati= on. - - You can add a Spring Project nature to an e= xisting project by right-clicking on the project and - selecting from the context menu: - -
- Adding Spring Project Nature - = - - - - -
- - - Once the nature is added, you will see a small "S= " decorating a Spring project in the Package Explorer - view. To remove the nature, right click the project and select = Remove Spring Project Nature: - -
- Project with Spring Nature - = - - - - -
- -After creating a Spring configuration file with bean definitions: - -
- Spring Configuration File - = - - - - -
- - Select Spring Beans project with Project >= ; Properties > Spring > Beans Support from the = menu bar: - -
- Spring Beans - = - - - - -
- - Now you can add the Spring bean configuration files to your project= by clicking on Add button: - -
- Adding Configuration Files - = - - - - -
- -Once you add this file, the file will be marked by an "S" = to indicate a Spring bean file: - -
- Spring Bean File - = - - - - -
- - To activate the Spring Beans view, select Wi= ndow > Show View... > Other and then = Spring Explorer> Spring Beans from the - menu bar: - -
- Selecting Spring Beans View - = - - - - -
- -The Spring Beans view shows a read-only outline view of the Spring b= ean configuration file: - -
- Spring Beans View - = - - - - -
- -Using a context menu, you can select a graph view of the Spring conf= iguration file's referenced - beans: - -
- Graph View - = - - - - -
-
- -
- -CSS Editor - - The CSS editor comes with the same features= you will find in all other JBoss Developer Studio editors. - - -Content assist -Validation and error checking - - -With the CSS (Cascading Style Sheet) editor, you can take advantage = of code prompting: - -
-CSS Editor - = - - - - -
- -You can also use the Outline view next to the editor to navigate thr= ough the CSS file: - -
-Outline View - = - - - - -
- -And you can also use the Properties view next to the editor to edit = existing stylesheet = -declaration properties: - -
-Properties View - = - - - - -
- -
-
- -JavaScript Editor - - The JavaScript editor includes a Preview vi= ewer and a Source viewer. In the Source viewer, you can use code assist: - -
-JavaScript Editor - = - - - - -
- -You can also use the Source viewer with the Outline view to navigate= around the file: - -
-Source Viewer - = - - - - -
- -
-
- -Image Viewer -This simple image viewer allows you to view GIF and JPEG files indiv= idually in a separate window: - -
-Image Viewer - = - - - - -
- -
-
- -XSD Editor - - JBoss Developer Studio comes with an XSD Editor for XML Schema files. This editor comes from the Web Tools Project (WT= P) (see WTP Getting Started). - - To create a new XSD file, right-click a folder in the Package Ex= plorer view, select New > Other... from the context menu and then select XML > XML= Schema in the dialog box. - -
-Creating New XSD file - = - - - - -
- - The XSD Editor includes two viewers for working on the file, a D= esign viewer and a Source viewer: - -
-Source Viewer - = - - - - -
- - In the Design viewer, you can drill down on an element by double= -clicking on it: - -
- Design Viewer - = - - - - -
- -Various edit options are available when you right-click an element i= n the diagram: - -
-Edit Options - = - - - - -
- -You can also use the Properties view to edit a selected element: - -
-Properties View - = - - - - -
- -You can also use a Source viewer for the file. In this viewer, along= with direct editing of the - source code, you can also edit the file by using the Properties view on t= he right: - -
-Source Viewer - = - - - - -
- -
-
- -Support for XML Schema - -JBoss Developer Studio fully supports XML files based on schemas as = well as DTDs: -
-XML File - = - - - - -
- -
-
\ No newline at end of file --===============2577041724047639661==--