[jbosstools-commits] JBoss Tools SVN: r7132 - in trunk/jsf/docs/userguide/en: modules and 1 other directory.
jbosstools-commits at lists.jboss.org
jbosstools-commits at lists.jboss.org
Wed Mar 26 14:55:20 EDT 2008
Author: ykryvinchanka
Date: 2008-03-26 14:55:20 -0400 (Wed, 26 Mar 2008)
New Revision: 7132
Modified:
trunk/jsf/docs/userguide/en/images/palette/palette_18.png
trunk/jsf/docs/userguide/en/images/palette/palette_7.png
trunk/jsf/docs/userguide/en/modules/palette.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-232 the structure of the chapter has been changed (the content was organized and added ) + new relevant links and screens
Modified: trunk/jsf/docs/userguide/en/images/palette/palette_18.png
===================================================================
(Binary files differ)
Modified: trunk/jsf/docs/userguide/en/images/palette/palette_7.png
===================================================================
(Binary files differ)
Modified: trunk/jsf/docs/userguide/en/modules/palette.xml
===================================================================
--- trunk/jsf/docs/userguide/en/modules/palette.xml 2008-03-26 18:39:31 UTC (rev 7131)
+++ trunk/jsf/docs/userguide/en/modules/palette.xml 2008-03-26 18:55:20 UTC (rev 7132)
@@ -1,6 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<chapter id="palette" xreflabel="palette">
<?dbhtml filename="palette.html"?>
+
<chapterinfo>
<keywordset>
<keyword>Jboss Tools palette</keyword>
@@ -9,6 +10,9 @@
</keywordset>
</chapterinfo>
<title>JBoss Tools Palette</title>
+ <para>This chapter will introdus you to the functionality provide by <property>JBoss Tools
+ Palette</property>. Palette allowes you to quickly and easily creat your JSP or JSF
+ page. Now you can do it more faster without additional knowlege.</para>
<para>The <property>JBoss Tools Palette</property> allows you to:</para>
<itemizedlist>
@@ -20,260 +24,74 @@
</listitem>
</itemizedlist>
- <para>The <property>JBoss Tools Palette</property> contains a developer's project tag libraries and provides possibility to add any tag
- libraries to it. Or you can choose a necessary one from the list of already existent tag
- libraries:</para>
+ <para>The JBoss Tools Palette contains a developer's project tag libraries and provides
+ possibility to add any tag libraries to it. Also you can choose a necessary one from the
+ list of already existent tag libraries:</para>
<itemizedlist>
- <listitem><para>HTML</para></listitem>
- <listitem><para>JBoss</para></listitem>
- <listitem><para>JSF</para></listitem>
- <listitem><para>JSTL</para></listitem>
- <listitem><para>MyFaces</para></listitem>
- <listitem><para>Oracle ADF Faces</para></listitem>
- <listitem><para>Struts</para></listitem>
- <listitem><para>XHTML</para></listitem>
+ <listitem>
+ <para>HTML</para>
+ </listitem>
+ <listitem>
+ <para>JBoss</para>
+ </listitem>
+ <listitem>
+ <para>JSF</para>
+ </listitem>
+ <listitem>
+ <para>JSTL</para>
+ </listitem>
+ <listitem>
+ <para>MyFaces</para>
+ </listitem>
+ <listitem>
+ <para>Oracle ADF Faces</para>
+ </listitem>
+ <listitem>
+ <para>Struts</para>
+ </listitem>
+ <listitem>
+ <para>XHTML</para>
+ </listitem>
</itemizedlist>
-
+
<figure>
- <title>Pallete Editor</title>
+ <title>JBoss Tools Palette</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/palette/palette_14.png"/>
+ <imagedata fileref="images/palette/palette_1.png"/>
</imageobject>
</mediaobject>
</figure>
-
- <section id="UsingThePalette(IncludingOne-ClickTagInsertion)">
- <?dbhtml filename="UsingThePalette(IncludingOne-ClickTagInsertion).html"?>
- <title>Using the Palette</title>
-
- <section id="RedHatPalette">
- <?dbhtml filename="JBossToolsPalette.html"?>
- <title>JBoss Tools Palette</title>
- <para> Palette Editor window is divided into multiple groups, and every group consists of several subgroups. For example, JSF consists of Core, Facelets, HTML: </para>
- <figure>
- <title>Subgroups of JSF group</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_24.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>By default the Palette is represented in Web Development Perspective with four
- groups. If you can't see it, select <emphasis>
- <property>Window > Show View Other... > JBoos Tools Web >
- JBoss Tools Palette</property>
- </emphasis> from the menu bar.</para>
-
- <figure>
- <title>JBoss Tools Palette</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>By using <property>Show/Hide</property> button you can add any predefined group of
- tag libraries. It's also possible to create your own group. </para>
+ <para>By default the Palette is represented in Web Development Perspective with four groups. If
+ you can't see it, select <emphasis>
+ <property>Window > Show View Other... > JBoos Tools Web > JBoss
+ Tools Palette</property>
+ </emphasis> from the menu bar.</para>
- </section>
-
- <section id="InsertingTagsIntoAJSPFile">
- <?dbhtml filename="InsertingTagsIntoAJSPFile.html"?>
- <title>Inserting Tags into a JSP File</title>
-
- <para>A new tag can be added into any text file including jsp, htm, html and xhtml.</para>
- <para>It's very simple to do this. Open your JSP file and place the cursor in a place where you'd
- like to add a tag and then click that tag in the palette.
-
- In the <property>Insert Tag</property> window, that will appeared after that action, you can set the
- <emphasis><property>value</property></emphasis> of general and advanced <emphasis><property>attributes</property></emphasis> of the tag that you chose.</para>
-
- <figure>
- <title>Inserting Tag</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_25.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>In the example below, the <emphasis><property>commandButton</property></emphasis> tag has been inserted.</para>
-
- <figure>
- <title>Inserting Tag</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_2.png" scale="80"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <note><title>Note:</title>
- <para>if you place the cursor over
- any tag, a balloon tip is shown with all the <emphasis role="italic">
- <property>"tag"</property>
- </emphasis> attributes.</para>
- </note>
-
- <para>The cursor position after adding a tag into a file is specified by
- "|" symbol in the tag template on the right in the Palette Editor window. </para>
- <figure>
- <title>Palette Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_15.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para> Above you can see where the cursor position for HTML/Form/input is set. Thus, after
- adding this tag into your file the cursor will be in the attribute
- "type". Then, you can straight use the combination of buttons <property>Ctrl
- + Space</property> to inquire about a prompting. </para>
-
- <figure>
- <title>Cursor position</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_16.png" scale="50"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- </section>
-
- <section id="AddingCustomJSFTagsToTheRedHatPalette7433">
- <?dbhtml filename="AddingCustomJSFTagsToTheJBossToolsPalette.html"?>
- <title>Adding Custom JSF Tags to the JBoss Tools Palette</title>
-
- <para>There are two ways to add any custom or 3rd party tag library to the
- <property>JBoss Tools Palette</property>:</para>
- <itemizedlist>
- <listitem>
- <para>Drag-and-drop from the Web Projects view</para>
- </listitem>
- <listitem>
- <para>The Import button on the JBoss Tools Palette</para>
- </listitem>
- </itemizedlist>
-
- <para>Before you can add your custom component library, you need to make sure it is
- included in your project. Either place the <emphasis role="italic">
- <property>".tld"</property>
- </emphasis> file or the <emphasis role="italic">
- <property>".jar"</property>
- </emphasis> that includes your tag library under the lib folder in your project.
- </para>
-
- <section id="Drag_and_Drop65332">
- <?dbhtml filename="DragAndDrop.html"?>
- <title>Drag-and-Drop</title>
- <para>Switch to the Web Projects view and expand the Tag Libraries folder. If the view
- not active, select <emphasis>
- <property>Window > Show View > Web Projects</property>
- </emphasis> from the menu bar.</para>
-
- <figure>
- <title>Web Projects View</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Also make sure that the JBoss Tools Palette is open. Select the tag library that
- you want to add and simply drag-and-drop it on to the JBoss Tools Palette.</para>
-
- <para>You will see the following dialog window. As you can see JBoss Developer Studio
- takes care of all the details. You just need to set the Group name to which you wish to place
- this tag library. You can either add this tag library to an existing Group or just
- create a new one.</para>
-
- <figure>
- <title>Import Tags From TLD File Form</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_4.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Once you are finished, you will see the new tag library added to the JBoss Tools
- Palette.</para>
-
- <figure>
- <title>JBoss Tools Palette with New Tag Library</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_5.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
- <section id="ImportButton521">
- <?dbhtml filename="ImportButton.html"?>
- <title>Import Button</title>
- <para>The same you can do with <emphasis><property>Import</property></emphasis> button.
- You can see this button at the top right side of the JBoss Tools Palette.</para>
-
- <figure>
- <title>Import Button</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_6.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>By clicking on the <emphasis><property>Import button</property></emphasis> you will see the Import Tag window a similar like in the Drag-and-Drop method.
- On this Import Tag form you can select <emphasis><property>Browse...</property></emphasis> to locate the tag library that you want to add.
- Also you need to set the Group name to which you'd like to add your tag library. And like in the previous method you can add it to an existing Group or create a new one.</para>
-
- <figure>
- <title>Import Tags From TLD File Form</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_7.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Now select the TLD file you want to be added:</para>
- <figure>
- <title>Select TLD File</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_8.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
- </section>
-
- </section>
-
<section id="PaletteOptions">
<?dbhtml filename="PaletteOptions.html"?>
<title>Palette Options</title>
+ <para>To case your work, you can configure the Palette for your own, by selecting the
+ corresponding icon on the Palette toolbar.</para>
+ <para>There is a possibility to configure the JBoss Tools Palette:</para>
- <para>There is possibility to configure the <property>JBoss Tools Palette</property>:</para>
-
<itemizedlist>
<listitem>
- <para> to edit the palette content by adding, removing or changing the palette
- elements</para>
+ <para> to <property>edit the palette</property> content by adding, removing or
+ changing the palette elements</para>
</listitem>
+
<listitem>
- <para> to show/hide groups, subgroups</para>
+ <para> to <property>show/hide groups</property>, subgroups</para>
</listitem>
+
<listitem>
- <para>to import groups, subgroups</para>
+ <para>to <property>import groups</property>, subgroups</para>
</listitem>
</itemizedlist>
-
+
<figure>
<title>Palette Buttons</title>
<mediaobject>
@@ -282,87 +100,239 @@
</imageobject>
</mediaobject>
</figure>
+
<section id="PaletteEditor">
<?dbhtml filename="PaletteEditor.html"?>
<title>Palette Editor</title>
- <para>To edit the Pallete view use <property>Edit</property> button. The Palette
- Editor provides following possibilities: <itemizedlist>
+ <para>JBoss Tools Palette contains existing libraries of tags, thus the
+ <property>Palette editor</property> is intended to work with them or create your
+ new one, as well.</para>
+ <para>To open the editor, click right mouse button on the <emphasis>
+ <property>Palette Editor</property>
+ </emphasis> icon: <itemizedlist>
+
+ <figure>
+ <title>Palette Editor Icon</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The window has two parts. There is a reflected grouped list of components
+ on the left side of the palette editor. Each group is divided into multiple
+ groups, every of which is a tag library. The right side of the palette
+ editor is an editing window where it's possible to change values of
+ group, tag library attributes that you've chosen on the left part
+ of the window. It can also be made by using <emphasis>
+ <property>Edit…</property>
+ </emphasis> button.</para>
+ <literallayout/>
+ <para> For example, <property>JSF</property> group consists of
+ <property>Core</property>, <property>Facelets</property>,
+ <property>HTML</property> tag libraries and the attributes as
+ <property>name</property>, <property>description</property> and
+ <property>hidden</property> which are available for editing: </para>
+
+ <figure>
+ <title>Tag Libraries of the JSF Group</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_24.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The Palette Editor provides the following possibilities when working with
+ existing tags or icons:</para>
<listitem>
- <para>to work with set of icons</para>
+ <para>to work with a set of icons</para>
+ <para><emphasis>
+ <property>Icons</property>
+ </emphasis> is the root folder for the icon sets. The first step is
+ creating the icon set. Right click on the <emphasis>
+ <property>Icons</property>
+ </emphasis> folder and select <emphasis>
+ <property>Create > Create Set...</property>
+ </emphasis></para>
+ <para>Set the value of the name in the <emphasis>
+ <property>Add Icons</property>
+ </emphasis> window and click <emphasis>
+ <property>Finish</property>
+ </emphasis> button. A new element will appear in the list.</para>
<figure>
- <title>Creating a set of icons</title>
+ <title>Creating a Set of Icons</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/palette/palette_17.png"/>
</imageobject>
</mediaobject>
</figure>
+ <para>Also you can delete the set. Right click on the set of icons that you
+ wish to remove and chose the <emphasis>
+ <property>Delete Set</property>
+ </emphasis> option from the pop-up menu or click the <emphasis>
+ <property>Delet</property>
+ </emphasis> keyboard button.</para>
</listitem>
-
-
+
<listitem>
<para>to edit icons in the chosen set</para>
+ <para>When the set of icons is created, new icons can be imported to it.
+ Choose the required set and select the option <emphasis>
+ <property>Create > Import Icon... </property>
+ </emphasis> from the pop-up menu that appears after you right-click on a
+ folder.</para>
<figure>
- <title>Editing icons</title>
+ <title>Creating Icons (retake screen with IMPORT ICON!!!)</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/palette/palette_18.png"/>
</imageobject>
</mediaobject>
</figure>
+ <para>Set the name of the icon and the path and click <emphasis>
+ <property>Finish</property>
+ </emphasis> button.</para>
</listitem>
-
+
<listitem>
- <para>to edit a group</para>
+ <para>to work with a group of tag libraries</para>
+ <para>The first step in work with the editor is creating a group of
+ libraries. It's very easy to do, right mouse button click on
+ the <emphasis>
+ <property>Palette</property>
+ </emphasis> folder and select <emphasis>
+ <property>Create > Create Group…</property>
+ </emphasis></para>
+ <para>Set a name of a group in the <property>Create Group</property> window
+ and click <emphasis>
+ <property>OK</property>
+ </emphasis> button. A new element will appear at the end of the list.</para>
<figure>
- <title>Editing a group</title>
+ <title>Creating a Group of Tag Libraries</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/palette/palette_19.png"/>
</imageobject>
</mediaobject>
</figure>
+ <para>You are allowed to edit or delete a group, as well. If you'd
+ like to change attributes of a group, use the right editing window of
+ the palette editor or the <emphasis>
+ <property>Edit...</property>
+ </emphasis> option, like it was mentioned before. In order to remove the
+ group, right click on the group that you wish to remove and chose the <emphasis>
+ <property>Delete</property>
+ </emphasis> option or click the <emphasis>
+ <property>Delete</property>
+ </emphasis> keyboard button.</para>
+ <important>
+ <title>Important:</title>
+ <para>The removal option is enabled only for custom folders.</para>
+ </important>
</listitem>
-
+
<listitem>
- <para>to edit a subgroup</para>
+ <para>to work with a tag library</para>
+
+ <para>The group maintains a list of tag libraries. If you'd like to
+ create your own library, click right mouse button on the group and
+ choose <emphasis>
+ <property>Create Group…</property>
+ </emphasis> option.</para>
<figure>
- <title>Editing a subgroup</title>
+ <title>Creating a tag library</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/palette/palette_20.png"/>
</imageobject>
</mediaobject>
</figure>
+ <para>After setting the attribute name and the path of the icon, click <emphasis>
+ <property>Ok</property>
+ </emphasis> button.</para>
+ <note>
+ <title>Note:</title>
+ <para>If you do not choose an icon the default one will be
+ assigned.</para>
+ </note>
+ <para>You are allowed to edit or delete the tag library, as well. If
+ you'd like to change attributes of the library or choose
+ another icon, use the right editing window of the palette editor or the <emphasis>
+ <property>Edit...</property>
+ </emphasis> option. In order to remove the tag library, right click on
+ the library that you wish to remove and chose the <emphasis>
+ <property>Delete</property>
+ </emphasis> option or click the <emphasis>
+ <property>Delete</property>
+ </emphasis> keyboard button.</para>
+ <important>
+ <title>Important:</title>
+ <para>The removal option is enabled only for custom tag
+ libraries.</para>
+ </important>
</listitem>
-
+
<listitem>
- <para>to edit a subgroup content</para>
+ <para>to work with a tag element</para>
+ <para>When the library folder is created, new tags can be added to it.
+ Choose the required library and select the option <emphasis>
+ <property>Create > Create Macro…</property>
+ </emphasis> from the pop-up menu that appears after you right-click on a
+ folder.</para>
<figure>
- <title>Editing a subgroup content</title>
+ <title>Creating a tag element</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/palette/palette_21.png"/>
</imageobject>
</mediaobject>
</figure>
- </listitem>
-
- <listitem>
- <para>to edit the Palette element or macro</para>
- <figure>
- <title>Editing the Palette element </title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/palette/palette_22.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>In the <property>Add Palette Macro</property> window, you can
+ configure the tag element. Attribute <emphasis>
+ <property>Name</property>
+ </emphasis> is mandatory to fill and it will be the name of the tag
+ element. Other settings are optional. You can choose the icon and set
+ the <emphasis>
+ <property>Start Text</property>
+ </emphasis> and the <emphasis>
+ <property>End Text</property>
+ </emphasis> for your tag element. If your tag text is too long, use the <emphasis>
+ <property>Change...</property>
+ </emphasis> button to see it all. After all the attributes are set,
+ click <emphasis>
+ <property>Finish</property>
+ </emphasis> button.</para>
+ <note>
+ <title>Note:</title>
+ <para>If you do not choose the icon it will be assigned by
+ default.</para>
+ </note>
+ <para>You are allowed to edit or delete the tag . If you'd like to
+ change the attributes of the tag or choose another icon for it, use the
+ right editing window of the palette editor or the <emphasis>
+ <property>Edit...</property>
+ </emphasis> option from the pop-up menu. In order to remove the tag,
+ right click on the tag that you wish to remove and chose the <emphasis>
+ <property>Delete</property>
+ </emphasis> option or click the <emphasis>
+ <property>Delete</property>
+ </emphasis> keyboard button.</para>
+ <important>
+ <title>Important:</title>
+ <para>The removal option is enabled only for custom tags. JBoss Palette
+ tags can not be removed but can be modified.</para>
+ </important>
+
<para>Parameters of the Palette element are put into the table on the right.
Table cells are provided with editors and modal dialogue windows for
- choosing necessary icons. For 'start text' and 'end text'(or macro) there is
- possibility to control the cursor position by using "|" symbol. </para>
+ choosing necessary icons. For 'start text' and
+ 'end text'(or macro) there is a possibility to control
+ the cursor position by using "|" symbol. </para>
+
<figure>
<title>Parameters of the Palette element</title>
<mediaobject>
@@ -372,8 +342,7 @@
</mediaobject>
</figure>
</listitem>
-
-
+
</itemizedlist>
</para>
</section>
@@ -386,13 +355,15 @@
<property>Show/Hide</property>
</emphasis> is a very useful feature that allows you to control the number of tag
groups that are shown on the palette.</para>
+
<itemizedlist>
<listitem>
<para>Click <emphasis>
<property>Show/Hide</property>
- </emphasis> button</para>
+ </emphasis> button, at the top right side of the JBoss Tools Palette.</para>
</listitem>
</itemizedlist>
+
<figure>
<title>Show/Hide Button</title>
<mediaobject>
@@ -404,10 +375,11 @@
<itemizedlist>
<listitem>
- <para>In the dialog Show/Hide Drawers check the groups you want to be shown on
- the palette:</para>
+ <para>In the dialog Show/Hide Drawers check the groups the libraries of which
+ you want to be shown on the palette:</para>
</listitem>
</itemizedlist>
+
<figure>
<title>Show/Hide Drawers</title>
<mediaobject>
@@ -416,12 +388,20 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>If libraries are not displayed in the palette, check whether they are selected.
+ Click the plus sign to expand the libraries of the group and make sure that a tick
+ is put next to the wanted libraries.</para>
+ <para>(When you deactivate the group(s), the JBoss Palette remembers your last chose.
+ The libraries… )</para>
+
<itemizedlist>
<listitem>
- <para>Click <emphasis>
- <property>OK</property>.</emphasis> The new groups will now be displayed on the palette:</para>
+ <para>Click <emphasis><property>OK</property>.</emphasis> The new groups will
+ now be shown on the palette:</para>
</listitem>
</itemizedlist>
+
<figure>
<title>New Added Groups</title>
<mediaobject>
@@ -430,32 +410,229 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>The name of the elements is compound. The first part is the group’s name and the
+ second is the library’s name.</para>
</section>
+
<section id="Import">
<?dbhtml filename="Import.html"?>
<title>Import</title>
- <para>The Import button lets you add a custom or 3rd party tag library to
- JBoss Tools Palette. Find out more information on how to add the tags see the <link linkend="ImportButton521">Adding Custom JSF Tags</link> section.
+ <para>The Import button lets you add a custom or 3rd party tag library to JBoss Tools
+ Palette. Find out more information on how to add particular tags see the <link
+ linkend="ImportButton521">Adding Custom JSF Tags</link> section.
<!--<link linkend="CreatingAndWorkingCustomCapability">Learn how to import</link>. --></para>
</section>
</section>
+
+ <section id="UsingThePalette(IncludingOne-ClickTagInsertion)">
+ <?dbhtml filename="UsingThePalette(IncludingOne-ClickTagInsertion).html"?>
+ <title>Using the Palette</title>
+
+
+
+ <section id="InsertingTagsIntoAJSPFile">
+ <?dbhtml filename="InsertingTagsIntoAJSPFile.html"?>
+ <title>Inserting Tags into a JSP File</title>
+
+ <para>A new tag can be added into any text file including jsp, htm, html and xhtml.</para>
+ <para>It's very simple to do this. Open your JSP file and place the cursor in a
+ place where you'd like to add a tag and then click that tag in the palette.
+ In the <property>Insert Tag</property> window, that appears, you can set the value of<emphasis>
+ <property>general</property>
+ </emphasis> and <emphasis>
+ <property>advanced</property>
+ </emphasis> attributes of the tag that you chose.</para>
+
+ <figure>
+ <title>Inserting Tag</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_25.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>In the example below, the <emphasis>
+ <property>commandButton</property>
+ </emphasis> tag has been inserted.</para>
+
+ <figure>
+ <title>Inserting Tag</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_2.png" scale="80"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tipe:</title>
+ <para>if you place the cursor over any tag, a balloon hint is shown with all the
+ <emphasis role="italic">
+ <property>"tag"</property>
+ </emphasis> attributes.</para>
+ </tip>
+
+ <para>The cursor position after adding a tag into a file is specified by
+ "|" symbol in the tag template on the right in the Palette Editor
+ window. </para>
+ <figure>
+ <title>Palette Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_15.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para> Above you can see where the cursor position for HTML/Form/input is set. Thus,
+ after adding this tag into your file the cursor will be in the attribute
+ "type". Then, you can straight use the combination of buttons
+ <property>Ctrl + Space</property> to inquire about a prompting. </para>
+
+ <figure>
+ <title>Cursor position</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_16.png" scale="50"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <section id="AddingCustomJSFTagsToTheRedHatPalette7433">
+ <?dbhtml filename="AddingCustomJSFTagsToTheJBossToolsPalette.html"?>
+ <title>Adding Custom JSF Tags to the JBoss Tools Palette</title>
+
+ <para>There are two ways to add any custom or 3rd party tag library to the
+ <property>JBoss Tools Palette</property>:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Drag-and-drop from the Web Projects view</para>
+ </listitem>
+ <listitem>
+ <para>The Import button on the JBoss Tools Palette</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Before you can add your custom component library, you need to make sure it is
+ included in your project. Either place the <emphasis role="italic">
+ <property>".tld"</property>
+ </emphasis> file or the <emphasis role="italic">
+ <property>".jar"</property>
+ </emphasis> that includes your tag library under the lib folder in your project. </para>
+
+ <section id="Drag_and_Drop65332">
+ <?dbhtml filename="DragAndDrop.html"?>
+ <title>Drag-and-Drop</title>
+ <para>Switch to the Web Projects view and expand the Tag Libraries folder. If the
+ view is not active, select <emphasis>
+ <property>Window > Show View > Web Projects</property>
+ </emphasis> from the menu bar.</para>
+
+ <figure>
+ <title>Web Projects View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Also make sure that the JBoss Tools Palette is open. Select the tag library
+ that you want to add and simply drag-and-drop it on to the JBoss Tools Palette.</para>
+
+ <para>You will see the following dialog window. As you can see JBoss Developer
+ Studio takes care of all the details. Chosen TLD file, name and prefix of the
+ library and Library URL are detected, thus just need to set the Group name to
+ which you wish to place this tag library. You can either add this tag library to
+ an existing Group or just create a new one.</para>
+
+ <figure>
+ <title>Import Tags From TLD File Form</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Once you are finished, you will see the new tag library added to the JBoss
+ Tools Palette.</para>
+
+ <figure>
+ <title>JBoss Tools Palette with New Tag Library</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section id="ImportButton521">
+ <?dbhtml filename="ImportButton.html"?>
+ <title>Import Button</title>
+ <para>The same you can do with <emphasis>
+ <property>Import</property>
+ </emphasis> button. You can see this button at the top right side of the JBoss
+ Tools Palette.</para>
+
+ <figure>
+ <title>Import Button</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>By clicking on the <emphasis>
+ <property>Import button</property>
+ </emphasis> you will see the Import Tag window a similar like in the <link
+ linkend="Drag_and_Drop65332"> Drag-and-Drop</link> method. Set the name and
+ prefix of the library and Library URL. Also you need to set the Group name to
+ which you'd like to add your tag library. And like in the previous
+ method you can add it to an existing Group or create a new one. On this Import
+ Tag form you can use <emphasis>
+ <property>Browse...</property>
+ </emphasis>button to locate the tag library that you want to add:</para>
+
+ <figure>
+ <title>Select TLD File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/palette/palette_8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ </section>
+
+ </section>
+
+
<section id="RichFacesSupport">
<?dbhtml filename="RichFacesSupport.html"?>
<title>Rich Faces Support</title>
-
- <para>JBoss Developer Studio comes with a tight integration with <emphasis><property>Rich Faces</property></emphasis> component framework.
- Rich Faces and Ajax4jsf in JBoss Tools Palette always exist, this palette is not dynamic and is not changed from file to file.
- JBoss Tools Palette supports only the last version of the Rich Faces components.
-
- <note><title>Note:</title>
- <para>If you'd like to know the last version of Rich Faces component framework see <ulink url="http://labs.jboss.com/jbossrichfaces/">JBoss RichFaces</ulink> site.</para>
- </note>
- After installing JBDS Rich Faces components as well as
- <emphasis><property>Ajax4jsf</property></emphasis> ones are already on the <property>JBoss Tools Palette</property>:</para>
-
+
+ <para>JBoss Developer Studio comes with a tight integration with <emphasis>
+ <property>Rich Faces</property>
+ </emphasis> component framework. Rich Faces and Ajax4jsf in JBoss Tools Palette always
+ exist, this palette is not dynamic and is not changed from file to file. JBoss Tools
+ Palette supports only the last version of the Rich Faces components. <tip>
+ <title>Tip:</title>
+ <para>If you'd like to know the last version of Rich Faces component
+ framework see <ulink url="http://labs.jboss.com/jbossrichfaces/">JBoss
+ RichFaces</ulink> site.</para>
+ </tip> After installing JBDS Rich Faces components, as well, as <emphasis>
+ <property>Ajax4jsf</property>
+ </emphasis> ones are already on the <property>JBoss Tools Palette</property>:</para>
+
<figure>
<title>Rich Faces Components</title>
<mediaobject>
@@ -464,9 +641,43 @@
</imageobject>
</mediaobject>
</figure>
-
- <!-- <para>Insert tag into JSP file </para>-->
-
+
+ <!-- <para>Insert tag into JSP file </para>-->
+
</section>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
</chapter>
More information about the jbosstools-commits
mailing list