From jbosstools-commits at lists.jboss.org Fri Nov 28 09:22:30 2008 Content-Type: multipart/mixed; boundary="===============4850310310976978194==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r12120 - trunk/jsf/docs/userguide/en/modules. Date: Fri, 28 Nov 2008 09:22:30 -0500 Message-ID: --===============4850310310976978194== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: ochikvina Date: 2008-11-28 09:22:30 -0500 (Fri, 28 Nov 2008) New Revision: 12120 Modified: trunk/jsf/docs/userguide/en/modules/editors.xml Log: https://jira.jboss.org/jira/browse/JBDS-442 - updating the VPE section acco= rding to Beta1 what's new; 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-11-28 14:21:40 UTC= (rev 12119) +++ trunk/jsf/docs/userguide/en/modules/editors.xml 2008-11-28 14:22:30 UTC= (rev 12120) @@ -41,8 +41,11 @@ = OpenOn lets you easily link directl= y from one resource to another in your project without using the Package Explorer= view (project tree). With - OpenOn, you can simply click on a reference to another fil= e and the file will be - opened. + OpenOn, you can simply use + F3 + or + Ctrl+Click + on a reference to another file and the file wi= ll be opened. = OpenOn is available for the following files: @@ -150,6 +153,31 @@ + + Richfaces tags + <rich:insert> + and + <a4j:include> + has also OpenOn suppo= rt. + +
+ OpenOn With Richfaces Tag + + + + + +
+ +
+ OpenOn With A4j Tag + + + + + +
+ = @@ -188,7 +216,7 @@ ESB XML = files - + = @@ -423,7 +451,8 @@ =
Struts Project Files - Content Assist features are available when you work = with Struts projects. + Content Assist features are available when you work = with Struts + projects. = =
@@ -509,7 +538,8 @@
= Content Assist for HTML Tags - Content assist for HTML tags has the same mechan= ism as for JSF tags: + Content assist for HTML tags has the same mechan= ism as for JSF + tags:
HTML Tags Content Assist @@ -638,7 +668,7 @@ Add bundle resource (property file) code - assist: + assist: @@ -695,7 +725,7 @@ = Restart Eclipse. You should now have code as= sist for the - component. + component. = @@ -709,7 +739,7 @@ files in either source or extra visual modes at the same t= ime. = The project is yours and so is the source. JBo= ss Developer - Studio provides you many different graphical ed= itors to speed your + Studio provides you many different graphica= l editors to speed your application development. At the same time, you always have= a full control over all project source files. Any changes you make in the source v= iew immediately appear in the graphical view. @@ -795,7 +825,8 @@
= The view is designed in the form of a split pane with to= ggle buttons for quickly - moving between Source, Visual or Source/Visual modes as sh= own on the figure above. + moving between Source, Visual or Source/Visual modes as sh= own on the figure + above. = One more way to toggle between the various states of the= split pane is using the shortcuts @@ -806,12 +837,12 @@ Tip: When editing large documents hiding the Visual part = will speed up the - editing. + editing. = It should be pointed out that, no matter in what mode yo= u are working, you get a full integration with Properties and = Outline - views: + views:
Integration with Properties and Outline Views</titl= e> <mediaobject> @@ -822,17 +853,74 @@ </figure> = <para>It's also possible to use the <link linkend=3D"pale= tte">JBoss Tools - Palette</link> to insert any tag from the list of tag libr= aries to the page you are - editing with just a click or drag-and-drop.</para> + Palette</link> to insert any tag from the list of tag = libraries to the page you + are editing with just a click or drag-and-drop.</para> <figure> <title>Inserting Tag From the Palette - +
= + Visual Page Editor provides the opt= ion for displaying + non-visual tags in Visual mode of the editor. To enable th= is option expand the + submenu in the top left corner of the Visual part and sele= ct + Show Non-visual tags.<= /para> + +
+ Enabling the Option for Showing Non-visual Tags</ti= tle> + <mediaobject> + <imageobject> + <imagedata fileref=3D"images/visual_page/visual_pa= ge_4a.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>On the figure you can see non-visual elements with gray = dashed borders.</para> + + <figure> + <title>Non-visual Tag in the VPE + + + + + +
+ + To disable this option again expand the same submenu and= select + Hide Non-visual tags.<= /para> + +
+ Non-visual Tag in the VPE + + + + + +
+ +
+ Commenting out Code + + VPE supports possibility to add= comments in files you are + working with (JSP, XHTML, etc.): + + + + HTML comments ( + <!-- -->= ) which are output to the client + + + + JSP comments ( + <%-- --%>) which are not output to the + client as part of the JSP page output + + +
+
= JSP Syntax Validation @@ -846,8 +934,8 @@ = Most web pages use the cascading style sheets (CSS) to c= ontrol the way they look. With Visual Page Editor you can easil= y stylise your pages. In - this section we are going to introduce you to a powerful m= echanism that VPE provides for - a complete control over pages styling. + this section we are going to introduce you to a powerful m= echanism that + VPE provides for a complete contr= ol over pages styling. =
Inline Style Editing @@ -937,7 +1025,7 @@ - = + To create new CSS class write its name in the Style class field and then configure style settings sw= itching between the tabs: @@ -979,8 +1067,8 @@ = The dialog for creating a new CSS class, which is ca= lled from New > Other... > JBoss Tools Web > CSS C= lass, - looks the same. - = + looks the same. +
New CSS Class Dialog @@ -1026,14 +1114,14 @@ Tag for Display field in the Template dialog requires specifying a - type of tag. It can be SPAN, DIV, TABLE or any other html = element. Here - it's also possible to mark weather the tag is childre= n or not (by checking + type of tag. It can be SPAN, DIV, TABLE or any other html = element. Check Children - ), whether it contains an IMG tag (by checking = - Icon - ) and specify a value for it. + , if you want to mark a tag as a child element.= = - What comes to the + The + Value + field is for setting a tag value. + As for the Style field, you can fill it out manually or make us= e of the button next to the field to bring the CSS Di= alog for editing @@ -1052,7 +1140,8 @@
= - Here it's possible to edit or remove any listed in = the table template. + Here it's possible to edit or remove any listed in = the table + template. =
= @@ -1080,7 +1169,7 @@ Preferences button provides a quick access to Visual Page - Editor preferences. + Editor preferences. =
Visual Page Editor Preferences Window</titl= e> @@ -1116,7 +1205,8 @@ runtime. Let's look at what functionality it = proposes.</para> = <para>The first two sections of the window let you def= ine actual runtime - folders. The example below will help you to clarif= y how this can be used.</para> + folders. The example below will help you to clarif= y how this can be + used.</para> = <para>Suppose you have the following project structure= :</para> = @@ -1170,10 +1260,10 @@ ]]></programlisting> = <para>This will work fine in runtime, but the <propert= y>Visual Page - Editor</property> doesn't know what - <emphasis>requestContextPath</emphasis> in design = time is. In order to see - the necessary styles applied in design time your s= hould add a path to your - stylesheet in the <property>CSS File Path</propert= y> section.</para> + Editor</property> doesn't know what + <emphasis>requestContextPath</emphasis> in des= ign time is. In order to + see the necessary styles applied in design time yo= ur should add a path to + your stylesheet in the <property>CSS File Path</pr= operty> section.</para> = <para>The next <property>URI</property> section lets y= ou add URI taglibs so that the editor knows where to find the tag libraries.<= /para> @@ -1196,8 +1286,8 @@ view</property>, you'll also see this exp= ression. Now press <emphasis> <property>Page Design Options</property> </emphasis> button and set the value for the - <emphasis>#{user.name}</emphasis> as - <emphasis><property>World</property>.</emphasis></= para> + <emphasis>"user.name"</emphasis> as + <emphasis><property>World</property>.</emp= hasis></para> = <figure> <title>Setting the Value for the EL Expression</ti= tle> @@ -1225,7 +1315,7 @@ = <para>You can find useful one more functionality provided by V= PE. At the bottom of the <property>Visual/Source view</property> there is a <pr= operty>Selection Tag - Bar</property>. It allows to see tags tree for a current c= omponent selected in + Bar</property>. It allows to see tags tree for a curre= nt component selected in Visual or Source mode.</para> = <figure> @@ -1240,7 +1330,7 @@ <para>If you want to hide the <property>Selection Tag Bar</pro= perty>, use the button in the form of a red cross on the lower right side. To reset = it again you should check the proper option in the <link linkend=3D"vpe_preferences"= >VPE - Preferences</link>.</para> + Preferences</link>.</para> </section> = <section id=3D"page_preview"> @@ -1278,7 +1368,7 @@ <title>Setup notes for Linux = Linux users may need to do the following to get the Visual Page - Editor to work correctly on their machines. + Editor to work correctly on their machines.= = The Visual Page Editor requires the library libstdc++.s= o.5. This library is contained in the compat-libstdc++-33.i386 package. @@ -1471,7 +1561,8 @@
- Content assist is available when editing the file us= ing the Source viewer: + Content assist is available when editing the file us= ing the Source + viewer: =
Content Assist @@ -1483,7 +1574,8 @@
= In the Source viewer, if at any point a tag is incor= rect or incomplete, an - error will be indicated next to the line and also in t= he Problems view below. + error will be indicated next to the line and also in t= he Problems view + below. =
Error Reporting @@ -1524,7 +1616,8 @@
= - You can add any new elements right in the = Tree viewer: + You can add any new elements right in the = Tree + viewer: =
Adding New Elements @@ -1724,7 +1817,8 @@
= - In the Design viewer, you can drill down on an element b= y double-clicking on it: + In the Design viewer, you can drill down on an element b= y double-clicking on + it: =
Design Viewer @@ -1735,7 +1829,8 @@
= - Various edit options are available when you right-click = an element in the diagram: + Various edit options are available when you right-click = an element in the + diagram: =
Edit Options @@ -1775,7 +1870,8 @@ = Support for XML Schema = - JBoss Developer Studio fully supports XML files based on= schemas as well as DTDs: + JBoss Developer Studio fully supports XML files based on= schemas as well as + DTDs:
XML File --===============4850310310976978194==--