From richfaces-svn-commits at lists.jboss.org Fri Aug 31 12:23:03 2007
Content-Type: multipart/mixed; boundary="===============0704397377935699410=="
MIME-Version: 1.0
From: richfaces-svn-commits at lists.jboss.org
To: richfaces-svn-commits at lists.jboss.org
Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r2665 - in
 trunk/docs/userguide/en/src/main: resources/images and 1 other directory.
Date: Fri, 31 Aug 2007 12:23:02 -0400
Message-ID: <E1IR9Gw-0007JJ-5C@committer01.frg.pub.inap.atl.jboss.com>

--===============0704397377935699410==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: vkukharchuk
Date: 2007-08-31 12:23:02 -0400 (Fri, 31 Aug 2007)
New Revision: 2665

Added:
   trunk/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes.des=
c.xml
   trunk/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes.xml
   trunk/docs/userguide/en/src/main/resources/images/recursiveTreeNodes1.png
Modified:
   trunk/docs/userguide/en/src/main/docbook/included/treeNodes.desc.xml
   trunk/docs/userguide/en/src/main/docbook/included/treeNodes.xml
Log:
http://jira.jboss.com/jira/browse/RF-658

Added: trunk/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes=
.desc.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/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes.de=
sc.xml	                        (rev 0)
+++ trunk/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes.de=
sc.xml	2007-08-31 16:23:02 UTC (rev 2665)
@@ -0,0 +1,32 @@
+<?xml version=3D"1.0" encoding=3D"UTF-8"?>
+<section>
+    <sectioninfo>
+        <keywordset>
+            <keyword>recursiveTreeNodes</keyword>
+        </keywordset>
+    </sectioninfo>
+    <section>
+        <title>Description</title>
+        <para>
+		The <property>rich:recursiveTreeNodes</property> provides possibility to=
 define data models and process nodes recursively.
+		</para>
+		=

+		<figure>
+        <title>Expanded tree with recursiveTreeNodes</title>    =

+		<mediaobject> =

+			<imageobject>
+				<imagedata fileref=3D"images/recursiveTreeNodes1.png"/>
+			</imageobject>
+		</mediaobject>
+		</figure>
+		=

+    </section>	=

+    <section>
+        <title>Key Features</title>
+        <itemizedlist>
+			<listitem>Allows to define combined data models</listitem>
+            <listitem>Possibility to define nodes for processing via attri=
butes</listitem>
+			<listitem>Allows to process nodes recursively</listitem>
+        </itemizedlist>
+    </section>
+</section>

Added: trunk/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes=
.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/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes.xm=
l	                        (rev 0)
+++ trunk/docs/userguide/en/src/main/docbook/included/recursiveTreeNodes.xm=
l	2007-08-31 16:23:02 UTC (rev 2665)
@@ -0,0 +1,233 @@
+<?xml version=3D'1.0' encoding=3D'UTF-8'?>
+<section>
+  <sectioninfo>
+    <keywordset>
+      <keyword>recursiveTreeNodes</keyword>
+      <keyword>rich:recursiveTreeNodes</keyword>
+      <keyword>HtmlRecursiveTreeNodes</keyword>
+    </keywordset>
+  </sectioninfo>
+
+  <table>
+    <title>Component identification parameters </title>
+    <tgroup cols=3D"2">
+      <thead>
+        <row>
+          <entry>Name</entry>
+          <entry>Value</entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry>component-type</entry>
+          <entry>org.richfaces.RecursiveTreeNodes</entry>
+        </row>
+        <row>
+          <entry>component-class</entry>
+          <entry>org.richfaces.component.html.HtmlRecursiveTreeNodes</entr=
y>
+        </row>
+        <row>
+          <entry>component-family</entry>
+          <entry>org.richfaces.RecursiveTreeNodes</entry>
+        </row>
+        <!--
+		<row>
+          <entry>renderer-type</entry>
+          <entry>org.richfaces.EffectRenderer</entry>
+        </row>
+		-->
+        <row>
+          <entry>tag-class</entry>
+          <entry>org.richfaces.taglib.RecursiveTreeNodesTag</entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </table>
+
+  <section>
+    <title>Creating the Component with a Page Tag</title>
+    <para>To create the simplest variant of <property>rich:recursiveTreeNo=
des</property> on a page, use the
+      following syntax:</para>
+
+    <para>
+      <emphasis role=3D"bold">Example:</emphasis>
+    </para>
+    <programlisting role=3D"XML"><![CDATA[...
+	<rich:recursiveTreeNodes var=3D"issue" root=3D"#{project.root}" nodes=3D"=
#{model.issues}">
+		...
+		<rich:treeNode>
+			 <!-- node content -->
+		</rich:treeNode>
+		=

+		<!-- Others nodes -->   =

+		...
+	</rich:recursiveTreeNodes>
+...
+]]></programlisting>
+  </section>
+
+  <section>
+    <title>Creating the Component Dynamically Using Java</title>
+
+    <para>
+      <emphasis role=3D"bold">Example:</emphasis>
+    </para>
+    <programlisting role=3D"JAVA"><![CDATA[import org.richfaces.component.=
html.HtmlRecursiveTreeNodes;
+...
+HtmlRecursiveTreeNodes myRecursiveTreeNodes =3D new HtmlRecursiveTreeNodes=
();
+...
+]]></programlisting>
+  </section>
+  =

+    <section>
+    <title>Details of Usage</title>
+    <para>
+      <emphasis role=3D"bold">The typical variant of using:</emphasis>
+    </para>
+    <programlisting role=3D"XML"><![CDATA[...
+<rich:tree adviseNodeOpened=3D"#{treeModelBean.adviseNodeOpened}" switchTy=
pe=3D"client">
+	<rich:treeNodes id=3D"project" nodes=3D"#{loaderBean.projects}" var=3D"pr=
oject">
+		=

+		<rich:treeNode>
+			<h:commandLink action=3D"#{project.click}" value=3D"Project: #{project.=
name}" />
+		</rich:treeNode>
+
+		<rich:recursiveTreeNodes id=3D"dir" var=3D"dir" root=3D"#{project.dirs}"=
 nodes=3D"#{dir.directories}">
+			=

+			<rich:treeNode>
+				<h:commandLink action=3D"#{dir.click}" value=3D"Directory: #{dir.name}=
" />
+			</rich:treeNode>
+			=

+			<rich:treeNodes id=3D"file" var=3D"file" nodes=3D"#{dir.files}">
+				<rich:treeNode>
+					<h:commandLink action=3D"#{file.click}" value=3D"File: #{file.name}" =
/>
+				</rich:treeNode>
+			</rich:treeNodes>
+			=

+			<rich:treeNodes id=3D"file1" var=3D"file" nodes=3D"#{dir.files}">
+				<rich:treeNode>
+					<h:commandLink action=3D"#{file.click}" value=3D"File1: #{file.name}"=
 />
+				</rich:treeNode>
+			</rich:treeNodes>
+
+			<rich:recursiveTreeNodes id=3D"archiveEntry" var=3D"archiveEntry"
+				root=3D"#{dir.files}" nodes=3D"#{archiveEntry.archiveEntries}" =

+				activeRoot=3D"#{archiveEntry.class.simpleName =3D=3D 'ArchiveFile'}"
+				activeNodes=3D"#{archiveEntry.class.simpleName =3D=3D 'ArchiveEntry'}">
+			=

+				<rich:treeNode id=3D"archiveEntryNode">
+					<h:commandLink action=3D"#{archiveEntry.click}" value=3D"Archive entr=
y: #{archiveEntry.name}" />
+				</rich:treeNode>
+				=

+			</rich:recursiveTreeNodes>
+			=

+		</rich:recursiveTreeNodes>
+	</rich:treeNodes>
+</rich:tree>
+...
+]]></programlisting>
+
+ </section>
+<!--
+  <section>
+    <title>Details of Usage</title>
+<para>	=

+	It is possible to use <property>&lt;rich:effect&gt;</property> in two mod=
es: =

+<itemizedlist>
+        <listitem>attached to the JSF components or html tags and triggere=
d by particular event.
+		Wiring effect with JSF components might be occurs on the server or clien=
t.
+		Wiring with html tag is possible only on the client side </listitem>
+        <listitem>invoking from the javascript code by effect name.
+		During the rendering, <property>rich:effect</property> generates the jav=
ascript function with defined name. When the function is called,
+		the effect is applied </listitem>
+</itemizedlist>
+</para>
+    <para>
+      <emphasis role=3D"bold">Those a the typical variants of using:</emph=
asis>
+    </para>
+    <programlisting role=3D"XML"><![CDATA[...
+
+<rich:panel>
+	<rich:effect event=3D"onmouseout" type=3D"Opacity" params=3D"duration:0.8=
,from:1.0,to:0.3" />
+    .... panel content ....
+</rich:panel>
+...
+
+
+<div id=3D"contentDiv">
+  ..... div content ......
+</div>
+
+<input type=3D"button" onclick=3D"hideDiv({duration:0.7})" value=3D"Hide" =
/>
+<input type=3D"button" onclick=3D"showDiv()" value=3D"Show" />
+
+<rich:effect  name=3D"hideDiv"  for=3D"contentDiv" type=3D"Fade" />
+<rich:effect  name=3D"showDiv"  for=3D"contentDiv" type=3D"Appear" />
+
+
+<rich:effect for=3D"window" event=3D"onload" type=3D"Appear" params=3D"id:=
'contentDiv',duration:0.8,from:0.3,to:1.0" />
+...
+]]></programlisting>
+
+    <figure>
+      <title>Initial:</title>
+
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref=3D"images/effect1.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+	=

+	<figure>
+      <title>When the mouse cursor is over:</title>
+
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref=3D"images/effect0.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+
+<para>
+<emphasis><property>&quot;name&quot;</property></emphasis> attribute defin=
es the name of the javascript function will
+be generated on the page when the component is rendered. You can invoke th=
is function to activate the effect. The function access one parameter.
+It is a set of effect options in JSON format. =

+</para> =

+
+<para>
+<emphasis><property>&quot;type&quot;</property></emphasis> attribute defin=
es the type of effect. For example, "Fade", "Blind", "Opacity". Take a look=
 at scriptaculous documentation
+for set of available effect. =

+</para>
+
+<para>
+<emphasis><property>&quot;for&quot;</property></emphasis> attribute define=
s the id of the component or html tag, the effect will be attached to.
+Richfaces converts the <emphasis><property>&quot;for&quot;</property></emp=
hasis> attribute value to the client id of the component if such component =
is found. If not, the value is left as is for possible
+wiring with on the DOM element's id on the client side.
+By default, the target of the effect is the same element that effect point=
ed to. However, the target element
+is might be overridden with <emphasis><property>&quot;effectId&quot;</prop=
erty></emphasis> option passed with <emphasis><property>&quot;params&quot;<=
/property></emphasis>
+attribute of with function paramenter.
+</para>
+
+<para>
+<emphasis><property>&quot;params&quot;</property></emphasis> attribute all=
ows to define the set of options possible for particurar effect.
+For example, 'duration', 'delay', 'from', 'to'. Additionally to the option=
s used by the effect itself, there are two option that might override
+the <property>rich:effect</property> attribute. Those are: =

+<itemizedlist>
+        <listitem><emphasis><property>&quot;effectId&quot;</property></emp=
hasis> allows to re-define the target of effect.
+		The option is overrire the value of <emphasis><property>&quot;for&quot;<=
/property></emphasis> attribute</listitem>
+        <listitem><emphasis><property>&quot;effectType&quot;</property></e=
mphasis> defines the effect type.
+		The option is overrire the value of <emphasis><property>&quot;type&quot;=
</property></emphasis> attribute</listitem>
+</itemizedlist>
+</para>
+	=

+ </section>
+   <section>
+    <title>Relevant resources links</title>
+    <para>
+      <ulink url=3D"http://livedemo.exadel.com/richfaces-demo/richfaces/ef=
fect.jsf?c=3Deffect">Here</ulink>
+      you can see the example of <emphasis role=3D"bold">&lt;rich:effect&g=
t;</emphasis> usage. </para>
+  </section>
+  =

+  -->
+</section>

Modified: trunk/docs/userguide/en/src/main/docbook/included/treeNodes.desc.=
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/docs/userguide/en/src/main/docbook/included/treeNodes.desc.xml	20=
07-08-31 15:43:09 UTC (rev 2664)
+++ trunk/docs/userguide/en/src/main/docbook/included/treeNodes.desc.xml	20=
07-08-31 16:23:02 UTC (rev 2665)
@@ -8,8 +8,7 @@
     <section>
         <title>Description</title>
         <para>
-		The <property>rich:treeNodes</property> provides possibility to combine =
<property>rich:treeNode</property>
-		to logical groups.
+		The <property>rich:treeNodes</property> provides possibility to define d=
ata models and create representations to them.
 		</para>
 		=

 		<figure>
@@ -25,9 +24,9 @@
     <section>
         <title>Key Features</title>
         <itemizedlist>
-			<listitem>Allows to define a set of nodes</listitem>
-            <listitem>No developers JavaScript writing needed to use it on=
 pages</listitem>
-			<listitem>Built-in Ajax processing</listitem>
+			<listitem>Allows to define combined data models</listitem>
+            <listitem>Possibility to define nodes for processing via attri=
butes</listitem>
+			<listitem>Allows to process nodes recursively</listitem>
         </itemizedlist>
     </section>
 </section>

Modified: trunk/docs/userguide/en/src/main/docbook/included/treeNodes.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/docs/userguide/en/src/main/docbook/included/treeNodes.xml	2007-08=
-31 15:43:09 UTC (rev 2664)
+++ trunk/docs/userguide/en/src/main/docbook/included/treeNodes.xml	2007-08=
-31 16:23:02 UTC (rev 2665)
@@ -78,106 +78,37 @@
 ...
 ]]></programlisting>
   </section>
-<!--
+
   <section>
     <title>Details of Usage</title>
-<para>	=

-	It is possible to use <property>&lt;rich:effect&gt;</property> in two mod=
es: =

-<itemizedlist>
-        <listitem>attached to the JSF components or html tags and triggere=
d by particular event.
-		Wiring effect with JSF components might be occurs on the server or clien=
t.
-		Wiring with html tag is possible only on the client side </listitem>
-        <listitem>invoking from the javascript code by effect name.
-		During the rendering, <property>rich:effect</property> generates the jav=
ascript function with defined name. When the function is called,
-		the effect is applied </listitem>
-</itemizedlist>
-</para>
     <para>
-      <emphasis role=3D"bold">Those a the typical variants of using:</emph=
asis>
+      <emphasis role=3D"bold">The typical variant of using:</emphasis>
     </para>
     <programlisting role=3D"XML"><![CDATA[...
-
-<rich:panel>
-	<rich:effect event=3D"onmouseout" type=3D"Opacity" params=3D"duration:0.8=
,from:1.0,to:0.3" />
-    .... panel content ....
-</rich:panel>
+	<rich:tree adviseNodeOpened=3D"#{treeModelBean.adviseNodeOpened}" switchT=
ype=3D"client">
+		<rich:treeNodes id=3D"project" nodes=3D"#{loaderBean.projects}" var=3D"p=
roject">
+			<rich:treeNode>
+				<h:commandLink action=3D"#{project.click}" value=3D"Project: #{project=
.name}" />
+			</rich:treeNode>
+			<rich:treeNodes id=3D"srcDir" var=3D"srcDir" nodes=3D"#{project.srcDirs=
}">
+				<rich:treeNode>
+					<h:commandLink action=3D"#{srcDir.click}" value=3D"Source directory: =
#{srcDir.name}" />
+				</rich:treeNode>
+				<rich:treeNodes id=3D"pkg" var=3D"pkg" nodes=3D"#{srcDir.packages}">
+					<rich:treeNode>
+						<h:commandLink action=3D"#{pkg.click}" value=3D"Package: #{pkg.name}=
" />
+					</rich:treeNode>
+					<rich:treeNodes id=3D"class" var=3D"class" nodes=3D"#{pkg.classes}">
+						<rich:treeNode>
+							<h:commandLink action=3D"#{class.click}" value=3D"Class: #{class.na=
me}" />
+						</rich:treeNode>
+					</rich:treeNodes>	=

+				</rich:treeNodes>
+			</rich:treeNodes>
+		</rich:treeNodes>
+	</rich:tree>
 ...
-
-
-<div id=3D"contentDiv">
-  ..... div content ......
-</div>
-
-<input type=3D"button" onclick=3D"hideDiv({duration:0.7})" value=3D"Hide" =
/>
-<input type=3D"button" onclick=3D"showDiv()" value=3D"Show" />
-
-<rich:effect  name=3D"hideDiv"  for=3D"contentDiv" type=3D"Fade" />
-<rich:effect  name=3D"showDiv"  for=3D"contentDiv" type=3D"Appear" />
-
-
-<rich:effect for=3D"window" event=3D"onload" type=3D"Appear" params=3D"id:=
'contentDiv',duration:0.8,from:0.3,to:1.0" />
-...
 ]]></programlisting>
 =

-    <figure>
-      <title>Initial:</title>
-
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref=3D"images/effect1.png"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
-	=

-	<figure>
-      <title>When the mouse cursor is over:</title>
-
-      <mediaobject>
-        <imageobject>
-          <imagedata fileref=3D"images/effect0.png"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
-
-<para>
-<emphasis><property>&quot;name&quot;</property></emphasis> attribute defin=
es the name of the javascript function will
-be generated on the page when the component is rendered. You can invoke th=
is function to activate the effect. The function access one parameter.
-It is a set of effect options in JSON format. =

-</para> =

-
-<para>
-<emphasis><property>&quot;type&quot;</property></emphasis> attribute defin=
es the type of effect. For example, "Fade", "Blind", "Opacity". Take a look=
 at scriptaculous documentation
-for set of available effect. =

-</para>
-
-<para>
-<emphasis><property>&quot;for&quot;</property></emphasis> attribute define=
s the id of the component or html tag, the effect will be attached to.
-Richfaces converts the <emphasis><property>&quot;for&quot;</property></emp=
hasis> attribute value to the client id of the component if such component =
is found. If not, the value is left as is for possible
-wiring with on the DOM element's id on the client side.
-By default, the target of the effect is the same element that effect point=
ed to. However, the target element
-is might be overridden with <emphasis><property>&quot;effectId&quot;</prop=
erty></emphasis> option passed with <emphasis><property>&quot;params&quot;<=
/property></emphasis>
-attribute of with function paramenter.
-</para>
-
-<para>
-<emphasis><property>&quot;params&quot;</property></emphasis> attribute all=
ows to define the set of options possible for particurar effect.
-For example, 'duration', 'delay', 'from', 'to'. Additionally to the option=
s used by the effect itself, there are two option that might override
-the <property>rich:effect</property> attribute. Those are: =

-<itemizedlist>
-        <listitem><emphasis><property>&quot;effectId&quot;</property></emp=
hasis> allows to re-define the target of effect.
-		The option is overrire the value of <emphasis><property>&quot;for&quot;<=
/property></emphasis> attribute</listitem>
-        <listitem><emphasis><property>&quot;effectType&quot;</property></e=
mphasis> defines the effect type.
-		The option is overrire the value of <emphasis><property>&quot;type&quot;=
</property></emphasis> attribute</listitem>
-</itemizedlist>
-</para>
-	=

  </section>
-   <section>
-    <title>Relevant resources links</title>
-    <para>
-      <ulink url=3D"http://livedemo.exadel.com/richfaces-demo/richfaces/ef=
fect.jsf?c=3Deffect">Here</ulink>
-      you can see the example of <emphasis role=3D"bold">&lt;rich:effect&g=
t;</emphasis> usage. </para>
-  </section>
-  =

-  -->
 </section>

Added: trunk/docs/userguide/en/src/main/resources/images/recursiveTreeNodes=
1.png
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=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)


Property changes on: trunk/docs/userguide/en/src/main/resources/images/recu=
rsiveTreeNodes1.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream


--===============0704397377935699410==--