Author: smukhina
Date: 2009-09-10 07:58:32 -0400 (Thu, 10 Sep 2009)
New Revision: 15524
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_log.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_repeat.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_dataTable.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_datascroller.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_page.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_tree.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml
Log:
https://jira.jboss.org/jira/browse/RF-2063 links to wiki articles are added
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_log.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_log.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_log.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -49,7 +49,7 @@
<para>
<emphasis role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[<a4j:log
level="ALL" popup="false" width="400"
height="200"/>]]></programlisting>
+ <programlisting role="XML"><a4j:log
level="ALL" popup="false" width="400"
height="200"/></programlisting>
<para>
The component defined this way is decoded on a page as <emphasis
role="bold">
@@ -107,5 +107,10 @@
<para>
Visit the <ulink
url="http://livedemo.exadel.com/richfaces-demo/richfaces/log.jsf?c=l...
page</ulink> at RichFaces LiveDemo for example of component usage and their
sources.
</para>
+ <para>
+ You can find some cases when <emphasis role="bold">
+ <property><a4j:log></property>
+ </emphasis> might cause JavaScript error on <ulink
url="http://www.jboss.org/community/wiki/AjaxCoreComponents"> Ajax Core
Components Page.</ulink>
+ </para>
</section>
</section>
\ No newline at end of file
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_repeat.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_repeat.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j_repeat.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -41,18 +41,18 @@
</para>
- <programlisting role="XML"><![CDATA[...
-<table>
- <tbody>
- <a4j:repeat value="#{repeatBean.items}" var="item"
ajaxKeys="#{updateBean.updatedRow}">
- <tr>
- <td><h:outputText value="#{item.code}"
id="item1" /></td>
- <td><h:outputText value="#{item.price}"
id="item2" /></td>
- </tr>
- </a4j:repeat>
- </tbody>
-</table>
- ...]]></programlisting>
+ <programlisting role="XML">...
+<table>
+ <tbody>
+ <a4j:repeat value="#{repeatBean.items}" var="item"
ajaxKeys="#{updateBean.updatedRow}">
+ <tr>
+ <td><h:outputText
value="#{item.code}" id="item1" /></td>
+ <td><h:outputText
value="#{item.price}" id="item2" /></td>
+ </tr>
+ </a4j:repeat>
+ </tbody>
+</table>
+ ...</programlisting>
<para>
The example above the <emphasis role="bold">
@@ -78,13 +78,13 @@
</para>
<para>The next example shows collection output as a plain HTML
list:</para>
- <programlisting role="XML"><![CDATA[<ul>
- <a4j:repeat ...>
- <li>...<li/>
+ <programlisting role="XML"><ul>
+ <a4j:repeat ...>
+ <li>...<li/>
...
- <li>...<li/>
- </a4j:repeat>
-</ul>]]></programlisting>
+ <li>...<li/>
+ </a4j:repeat>
+</ul></programlisting>
<para>All other general attributes are defined according to the
similar
attributes of iterative components (<emphasis
role="bold">
<property><h:dataTable></property>
@@ -134,5 +134,11 @@
<para>
Visit the <ulink
url="http://livedemo.exadel.com/richfaces-demo/richfaces/repeat.jsf?...
page</ulink> at RichFaces LiveDemo for examples of component usage and their
sources.
</para>
- </section>
+
+ <para>
+ <ulink
url="http://www.jboss.org/community/wiki/Cantusea4jrepeattoiterateth...
you can find information why you can't use <emphasis
role="bold"><property><a4j:repeat></property>
</emphasis> to iterate the menuItems, tabs and way to solve this problem.
+
+ </para>
+
+ </section>
</section>
\ No newline at end of file
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_dataTable.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_dataTable.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_dataTable.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -72,40 +72,40 @@
<para>
<emphasis role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<rich:dataTable value="#{capitalsBean.capitals}" var="cap"
rows="5">
- <f:facet name="caption">
- <h:outputText value="United States Capitals" />
- </f:facet>
- <f:facet name="header">
- <h:outputText value="Capitals and States Table" />
- </f:facet>
- <rich:column>
- <f:facet name="header">State Flag</f:facet>
- <h:graphicImage value="#{cap.stateFlag}"/>
- <f:facet name="footer">State Flag</f:facet>
- </rich:column>
- <rich:column>
- <f:facet name="header">State Name</f:facet>
- <h:outputText value="#{cap.state}"/>
- <f:facet name="footer">State Name</f:facet>
- </rich:column>
- <rich:column >
- <f:facet name="header">State Capital</f:facet>
- <h:outputText value="#{cap.name}"/>
- <f:facet name="footer">State Capital</f:facet>
- </rich:column>
- <rich:column>
- <f:facet name="header">Time Zone</f:facet>
- <h:outputText value="#{cap.timeZone}"/>
- <f:facet name="footer">Time Zone</f:facet>
- </rich:column>
- <f:facet name="footer">
- <h:outputText value="Capitals and States Table" />
- </f:facet>
-</rich:dataTable>
+ <programlisting role="XML">...
+<rich:dataTable value="#{capitalsBean.capitals}" var="cap"
rows="5">
+ <f:facet name="caption">
+ <h:outputText value="United States Capitals" />
+ </f:facet>
+ <f:facet name="header">
+ <h:outputText value="Capitals and States Table" />
+ </f:facet>
+ <rich:column>
+ <f:facet name="header">State
Flag</f:facet>
+ <h:graphicImage value="#{cap.stateFlag}"/>
+ <f:facet name="footer">State
Flag</f:facet>
+ </rich:column>
+ <rich:column>
+ <f:facet name="header">State
Name</f:facet>
+ <h:outputText value="#{cap.state}"/>
+ <f:facet name="footer">State
Name</f:facet>
+ </rich:column>
+ <rich:column >
+ <f:facet name="header">State
Capital</f:facet>
+ <h:outputText value="#{cap.name}"/>
+ <f:facet name="footer">State
Capital</f:facet>
+ </rich:column>
+ <rich:column>
+ <f:facet name="header">Time
Zone</f:facet>
+ <h:outputText value="#{cap.timeZone}"/>
+ <f:facet name="footer">Time
Zone</f:facet>
+ </rich:column>
+ <f:facet name="footer">
+ <h:outputText value="Capitals and States Table" />
+ </f:facet>
+</rich:dataTable>
...
-]]></programlisting>
+</programlisting>
<para>This is a result:</para>
@@ -328,5 +328,8 @@
<para>From <ulink
url="http://www.jboss.org/community/docs/DOC-11861">"ri...
border to 0px "</ulink> article you'll figure out how to set rich:dataTable
border to 0px </para>
<para>
<ulink
url="http://www.jboss.org/community/docs/DOC-11860">dataTable Background Out
</ulink> tells you how to remove rich:dataTable header background</para>
+ <para>
+ <ulink
url="http://www.jboss.org/community/wiki/RichfacesDatatableCheckbox&...
Datatable Checkbox"</ulink> article helps you to create a Richface Datatable
with Checkbox Column and an CheckAll Checkbox in Header.
+ </para>
</section>
</section>
\ No newline at end of file
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_datascroller.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_datascroller.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_datascroller.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -108,16 +108,16 @@
<para>
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[ ...
-<rich:datascroller for="table" maxPages="10">
- <f:facet name="first">
- <h:outputText value="First"/>
- </f:facet>
- <f:facet name="last">
- <h:outputText value="Last"/>
- </f:facet>
-</rich:datascroller>
-...]]></programlisting>
+ <programlisting role="XML"> ...
+<rich:datascroller for="table" maxPages="10">
+ <f:facet name="first">
+ <h:outputText value="First"/>
+ </f:facet>
+ <f:facet name="last">
+ <h:outputText value="Last"/>
+ </f:facet>
+</rich:datascroller>
+...</programlisting>
<figure>
<title>
<emphasis role="bold">
@@ -151,42 +151,42 @@
<para>
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<h:form id="myForm">
- <rich:dataTable id="carList" rows="7"
value="#{dataTableScrollerBean.allCars}" var="category">
- <f:facet name="header">
- <rich:columnGroup>
- <h:column>
- <h:outputText value="Make" />
- </h:column>
- <h:column>
- <h:outputText value="Model" />
- </h:column>
- <h:column>
- <h:outputText value="Price" />
- </h:column>
- </rich:columnGroup>
- </f:facet>
- <h:column>
- <h:outputText value="#{category.make}" />
- </h:column>
- <h:column>
- <h:outputText value="#{category.model}" />
- </h:column>
- <h:column>
- <h:outputText value="#{category.price}" />
- </h:column>
- </rich:dataTable>
- <rich:datascroller id="sc2" for="carList"
reRender="sc1" maxPages="7"
page="#{dataTableScrollerBean.scrollerPage}" />
- <h:panelGrid>
- <h:panelGroup>
- <h:outputText value="Set current page number:" />
- <h:inputText value="#{dataTableScrollerBean.scrollerPage}"
id="sc1" size="1"/>
- <h:commandButton value="Set" />
- </h:panelGroup>
- </h:panelGrid>
-</h:form>
-...]]></programlisting>
+ <programlisting role="XML">...
+<h:form id="myForm">
+ <rich:dataTable id="carList" rows="7"
value="#{dataTableScrollerBean.allCars}" var="category">
+ <f:facet name="header">
+ <rich:columnGroup>
+ <h:column>
+ <h:outputText value="Make" />
+ </h:column>
+ <h:column>
+ <h:outputText value="Model" />
+ </h:column>
+ <h:column>
+ <h:outputText value="Price" />
+ </h:column>
+ </rich:columnGroup>
+ </f:facet>
+ <h:column>
+ <h:outputText value="#{category.make}" />
+ </h:column>
+ <h:column>
+ <h:outputText value="#{category.model}" />
+ </h:column>
+ <h:column>
+ <h:outputText value="#{category.price}" />
+ </h:column>
+ </rich:dataTable>
+ <rich:datascroller id="sc2" for="carList"
reRender="sc1" maxPages="7"
page="#{dataTableScrollerBean.scrollerPage}" />
+ <h:panelGrid>
+ <h:panelGroup>
+ <h:outputText value="Set current page number:" />
+ <h:inputText value="#{dataTableScrollerBean.scrollerPage}"
id="sc1" size="1"/>
+ <h:commandButton value="Set" />
+ </h:panelGroup>
+ </h:panelGrid>
+</h:form>
+...</programlisting>
<para> In the example above you can enter the page number you
want and set it by
clicking on the <emphasis role="bold">
@@ -232,32 +232,32 @@
<para>
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<h:form>
- <rich:dataTable value="#{capitalsBean.capitals}" var="cap"
rows="5">
- <rich:column>
- <h:outputText value="#{cap.name}" />
- </rich:column>
- <f:facet name="footer">
- <rich:datascroller pageIndexVar="pageIndex"
pagesVar="pages">
- <f:facet name="pages">
- <h:outputText value="#{pageIndex} / #{pages}" />
- </f:facet>
- </rich:datascroller>
- </f:facet>
- </rich:dataTable>
-</h:form>
+ <programlisting role="XML">...
+<h:form>
+ <rich:dataTable value="#{capitalsBean.capitals}" var="cap"
rows="5">
+ <rich:column>
+ <h:outputText value="#{cap.name}" />
+ </rich:column>
+ <f:facet name="footer">
+ <rich:datascroller pageIndexVar="pageIndex"
pagesVar="pages">
+ <f:facet name="pages">
+ <h:outputText value="#{pageIndex} / #{pages}" />
+ </f:facet>
+ </rich:datascroller>
+ </f:facet>
+ </rich:dataTable>
+</h:form>
...
-]]></programlisting>
+</programlisting>
<para> It's possible to insert optional separators between
controls.
For this purpose use a <emphasis>
<property>"controlsSeparator"</property>
</emphasis> facet. An example is placed below.
</para>
- <programlisting role="XML"><![CDATA[ ...
-<f:facet name="controlsSeparator">
- <h:graphicImage value="/image/sep.png"/>
-</f:facet>
-...]]></programlisting>
+ <programlisting role="XML"> ...
+<f:facet name="controlsSeparator">
+ <h:graphicImage value="/image/sep.png"/>
+</f:facet>
+...</programlisting>
<para> Starting from 3.2.1 of RichFaces multiple <emphasis
role="bold">
<property><rich:datascroller></property>
</emphasis> instances behavior and page bindings are
corrected.
@@ -534,5 +534,14 @@
</emphasis> and <emphasis
role="bold">
<property><rich:datascroller></property>
</emphasis> in a context of Extended Data Model see
on the <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewtopic&...
Users Forum</ulink>.</para>
+ <para>
+ <ulink
url="http://www.jboss.org/community/wiki/DataTablemodeldoesntgetupda...
article</ulink> describes how to solve <emphasis
role="bold"><property><rich:datatable></property></emphasis>
update problem when <emphasis
role="bold"><property><rich:datascroller></property></emphasis>
used.
+ </para>
+ <para>
+ <ulink
url="http://www.jboss.org/community/wiki/Howtousepairofrichdatascrol...
Here</ulink> you can find out how to use pair of <emphasis
role="bold"><property><rich:datascrollers></property></emphasis>
outside the any dataTable.
+ </para>
+ <para>
+ The solution about how to make <emphasis
role="bold"><property><rich:datascroller></property></emphasis>
be updated after sorting/filtering can be found on <ulink
url="http://www.jboss.org/community/wiki/richdataScrollerisnotupdate...
Iteration Components FAQ. </ulink>
+ </para>
</section>
</section>
\ No newline at end of file
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_page.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_page.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_page.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -92,17 +92,17 @@
<emphasis role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<rich:page pageTitle="The title of the page"
markupType="xhtml">
- <f:facet name="pageHeader">
- <meta content="The rich:page component" name="keywords" />
- <link rel="shortcut icon" href="/images/favicon.ico" />
- <link href="/css/style.css" rel="stylesheet"
type="text/css" />
- <script type="text/javascript"
src="/js/menu.js"></script>
- </f:facet>
- <!-- page content -->
-</rich:page>
-...]]></programlisting>
+ <programlisting role="XML">...
+<rich:page pageTitle="The title of the page"
markupType="xhtml">
+ <f:facet name="pageHeader">
+ <meta content="The rich:page component" name="keywords"
/>
+ <link rel="shortcut icon" href="/images/favicon.ico"
/>
+ <link href="/css/style.css" rel="stylesheet"
type="text/css" />
+ <script type="text/javascript"
src="/js/menu.js"></script>
+ </f:facet>
+ <!-- page content -->
+</rich:page>
+...</programlisting>
<note>
<title>Note:</title>
<para>Note, the <emphasis role="bold">
@@ -125,20 +125,20 @@
- <programlisting role="XML"><![CDATA[...
-<rich:page sidebarPosition="left" sidebarWidth="300">
- <f:facet name="header">
- <!-- header content -->
- </f:facet>
- <f:facet name="sidebar">
- <!-- side panel content -->
- </f:facet>
- <!-- body content -->
- <f:facet name="footer">
- <!-- footer content -->
- </f:facet>
-</rich:page>
-...]]></programlisting>
+ <programlisting role="XML">...
+<rich:page sidebarPosition="left" sidebarWidth="300">
+ <f:facet name="header">
+ <!-- header content -->
+ </f:facet>
+ <f:facet name="sidebar">
+ <!-- side panel content -->
+ </f:facet>
+ <!-- body content -->
+ <f:facet name="footer">
+ <!-- footer content -->
+ </f:facet>
+</rich:page>
+...</programlisting>
<para>The <emphasis role="bold">
<property><rich:page></property>
</emphasis> component also provides attributes to define CSS classes for
each nested facet as well as a body part of the page created with the
component.</para>
@@ -286,5 +286,9 @@
<property><rich:page></property>
</emphasis> component usage and sources for the given example.
</para>
<para>The <ulink
url="http://www.jboss.org/community/docs/DOC-13336">Layout components for
RichFaces 3.3.1</ulink> on the
JBoss.org Wiki</para>
+ <para>
+ Refer to the <ulink
url="https://www.jboss.org/community/wiki/Changingthelayoutofthepage...
the layout of the page dynamically"</ulink> to find out how to change the
layout of a page on the fly with <emphasis role="bold">
+
<property><rich:page></property></emphasis>.
+ </para>
</section>
</section>
\ No newline at end of file
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_tree.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_tree.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_tree.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -93,7 +93,7 @@
<property><rich:tree></property>
</emphasis> is built from a simple
<code>org.richfaces.model.TreeNode</code> model: </para>
- <programlisting role="JAVA"><![CDATA[...
+ <programlisting role="JAVA">...
private TreeNodeImpl<String> stationRoot = new
TreeNodeImpl<String>();
private TreeNodeImpl<String> stationNodes = new
TreeNodeImpl<String>();
private String[] kickRadioFeed = { "Hall & Oates - Kiss On My List",
@@ -108,20 +108,20 @@
child.setData(kickRadioFeed[i]);
stationRoot.addChild(i, child);
}
-...]]></programlisting>
+...</programlisting>
<para> As it is mentioned before you need to pass
<code>#{stations.stationNodes}</code>
property to the <emphasis>
<property>"value"</property>
</emphasis> attribute and define the
<emphasis>
<property>"var"</property>
</emphasis> attribute in order to refer to the data:
</para>
- <programlisting role="XML"><![CDATA[...
-<rich:tree value="#{stations.stationNodes}" var="station">
- <rich:treeNode>
- <h:outputText value="#{station}" />
- </rich:treeNode>
-</rich:tree>
-...]]></programlisting>
+ <programlisting role="XML">...
+<rich:tree value="#{stations.stationNodes}"
var="station">
+ <rich:treeNode>
+ <h:outputText value="#{station}" />
+ </rich:treeNode>
+</rich:tree>
+...</programlisting>
<para> This is a result: </para>
<figure>
<title>A simple <emphasis
role="bold">
@@ -151,39 +151,39 @@
<property><rich:tree></property>
</emphasis> from a local XML file. In the following
example a simple
XML file (stations.xml) is used as a radio station
playlist: </para>
- <programlisting role="XML"><![CDATA[<?xml
version="1.0"?>
-<station name="KickRadio">
- <feed date="today">
- <song time="07:00">Hall & Oates - Kiss On My
List</song>
- <song time="07:03">David Bowie - Let's Dance</song>
- <song time="07:06">Lyn Collins - Think (About It)</song>
- <song time="07:10">Kim Carnes - Bette Davis Eyes</song>
- <song time="07:15">KC & the Sunshine Band - Give It
Up</song>
- </feed>
-</station>]]></programlisting>
+ <programlisting role="XML"><?xml
version="1.0"?>
+<station name="KickRadio">
+ <feed date="today">
+ <song time="07:00">Hall & Oates - Kiss On My
List</song>
+ <song time="07:03">David Bowie - Let's
Dance</song>
+ <song time="07:06">Lyn Collins - Think (About
It)</song>
+ <song time="07:10">Kim Carnes - Bette Davis
Eyes</song>
+ <song time="07:15">KC & the Sunshine Band - Give It
Up</song>
+ </feed>
+</station></programlisting>
<para> Now you need to create a bean that holds a model nodes:
</para>
- <programlisting role="JAVA"><![CDATA[...
+ <programlisting role="JAVA">...
private TreeNode data;
...
FacesContext context = FacesContext.getCurrentInstance();
data = XmlTreeDataBuilder.build(new
InputSource(getClass().getResourceAsStream("stations.xml")));
-...]]></programlisting>
+...</programlisting>
<para> Finally you should set the <emphasis>
<property>"value"</property>
</emphasis> attribute to the
<code>data</code> bean property and
define the <emphasis>
<property>"var"</property>
</emphasis> attribute in order to refer to the data
of nodes: </para>
- <programlisting role="XML"><![CDATA[...
-<rich:tree id="treeXML" value="#{stations.data}"
var="vardata">
- <rich:treeNode>
- <h:outputText value="#{vardata.attributes['name']}" />
- <h:outputText value="#{vardata.attributes['date']}" />
- <h:outputText value="#{vardata.attributes['time']}" />
- <h:outputText value=" #{vardata.text}" />
- </rich:treeNode>
-</rich:tree>
-...]]></programlisting>
+ <programlisting role="XML">...
+<rich:tree id="treeXML" value="#{stations.data}"
var="vardata">
+ <rich:treeNode>
+ <h:outputText value="#{vardata.attributes['name']}" />
+ <h:outputText value="#{vardata.attributes['date']}" />
+ <h:outputText value="#{vardata.attributes['time']}" />
+ <h:outputText value=" #{vardata.text}" />
+ </rich:treeNode>
+</rich:tree>
+...</programlisting>
<para>This is a result:</para>
<figure>
<title>A simple <emphasis
role="bold">
@@ -220,21 +220,21 @@
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<h:form>
- <rich:tree style="width:300px" value="#{library.data}"
var="item" nodeFace="#{item.type}">
- <rich:treeNode type="artist"
iconLeaf="/images/tree/singer.png" icon="/images/tree/singer.png">
- <h:outputText value="#{item.name}" />
- </rich:treeNode>
- <rich:treeNode type="album"
iconLeaf="/images/tree/disc.png" icon="/images/tree/disc.png">
- <h:outputText value="#{item.title}" />
- </rich:treeNode>
- <rich:treeNode type="song"
iconLeaf="/images/tree/song.png" icon="/images/tree/song.png">
- <h:outputText value="#{item.title}" />
- </rich:treeNode>
- </rich:tree>
-</h:form>
-...]]></programlisting>
+ <programlisting role="XML">...
+<h:form>
+ <rich:tree style="width:300px" value="#{library.data}"
var="item" nodeFace="#{item.type}">
+ <rich:treeNode type="artist"
iconLeaf="/images/tree/singer.png"
icon="/images/tree/singer.png">
+ <h:outputText value="#{item.name}" />
+ </rich:treeNode>
+ <rich:treeNode type="album"
iconLeaf="/images/tree/disc.png" icon="/images/tree/disc.png">
+ <h:outputText value="#{item.title}" />
+ </rich:treeNode>
+ <rich:treeNode type="song"
iconLeaf="/images/tree/song.png" icon="/images/tree/song.png">
+ <h:outputText value="#{item.title}" />
+ </rich:treeNode>
+ </rich:tree>
+</h:form>
+...</programlisting>
<para>This is a result: </para>
<figure>
<title>The <emphasis>
@@ -282,9 +282,9 @@
<para>
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="JAVA"><![CDATA[
+ <programlisting role="JAVA">
nodeFace="#{data.name != 'param-value' ? 'artist' :
'album'}"
- ]]></programlisting>
+ </programlisting>
<para>There are some essential points in a <emphasis>
<property>"nodeFace"</property>
</emphasis> attribute usage: you need to define
notions for
@@ -309,9 +309,9 @@
<para>
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<h:outputText value="#{varAttributeName}">
-...]]></programlisting>
+ <programlisting role="XML">...
+<h:outputText value="#{varAttributeName}">
+...</programlisting>
<para>
<emphasis>
<property>"varAttributeName"</property>
@@ -366,22 +366,22 @@
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<h:form>
- <rich:tree style="width:300px" value="#{library.data}"
var="item" nodeFace="#{item.type}">
+ <programlisting role="XML">...
+<h:form>
+ <rich:tree style="width:300px" value="#{library.data}"
var="item" nodeFace="#{item.type}">
...
- <rich:treeNode type="album"
iconLeaf="/images/tree/album.gif" icon="/images/tree/album.gif"
- rendered="#{item.exist}">
- <h:outputText value="#{item.name}" />
- </rich:treeNode>
- <rich:treeNode type="album"
iconLeaf="/images/tree/album_absent.gif"
icon="/images/tree/album_absent.gif"
- rendered="#{not item.exist}">
- <h:outputText value="#{item.name}" />
- </rich:treeNode>
+ <rich:treeNode type="album"
iconLeaf="/images/tree/album.gif" icon="/images/tree/album.gif"
+ rendered="#{item.exist}">
+ <h:outputText value="#{item.name}" />
+ </rich:treeNode>
+ <rich:treeNode type="album"
iconLeaf="/images/tree/album_absent.gif"
icon="/images/tree/album_absent.gif"
+ rendered="#{not item.exist}">
+ <h:outputText value="#{item.name}" />
+ </rich:treeNode>
...
- </rich:tree>
-</h:form>
-...]]></programlisting>
+ </rich:tree>
+</h:form>
+...</programlisting>
<para>This is a result of the code: </para>
<figure>
<title>The <emphasis>
@@ -456,24 +456,24 @@
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<rich:tree value="#{library.data}" var="item">
+ <programlisting role="XML">...
+<rich:tree value="#{library.data}" var="item">
...
- <f:facet name="icon">
- <h:graphicImage value="/images/tree/singer.png "/>
- </f:facet>
- <f:facet name="iconCollapsed">
- <h:graphicImage value="/images/tree/singer.png" />
- </f:facet>
- <f:facet name="iconExpanded">
- <h:graphicImage value="/images/tree/singer.png" />
- </f:facet>
- <f:facet name="iconLeaf">
- <h:graphicImage value="/images/tree/song.png" />
- </f:facet>
+ <f:facet name="icon">
+ <h:graphicImage value="/images/tree/singer.png "/>
+ </f:facet>
+ <f:facet name="iconCollapsed">
+ <h:graphicImage value="/images/tree/singer.png" />
+ </f:facet>
+ <f:facet name="iconExpanded">
+ <h:graphicImage value="/images/tree/singer.png" />
+ </f:facet>
+ <f:facet name="iconLeaf">
+ <h:graphicImage value="/images/tree/song.png" />
+ </f:facet>
...
-</rich:tree>
-...]]></programlisting>
+</rich:tree>
+...</programlisting>
<para> The <emphasis role="bold">
<property><rich:
tree></property>
@@ -566,17 +566,17 @@
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<rich:tree value="#{treeBean.data}" var="node"
switchType="ajax"
rowKeyConverter="org.richfaces.TreeRowKeyConverter">
- <rich:treeNode ajaxSingle="true">
- <h:outputText value="#{node}"/>
- </rich:treeNode>
-</rich:tree>
-...]]></programlisting>
+ <programlisting role="XML">...
+<rich:tree value="#{treeBean.data}" var="node"
switchType="ajax"
rowKeyConverter="org.richfaces.TreeRowKeyConverter">
+ <rich:treeNode ajaxSingle="true">
+ <h:outputText value="#{node}"/>
+ </rich:treeNode>
+</rich:tree>
+...</programlisting>
<para>In the example the tree uses the following data
model:</para>
- <programlisting role="JAVA"><![CDATA[...
+ <programlisting role="JAVA">...
String[ ] components = {"< a4j:ajaxListener >", "<
a4j:keepAlive >", "< a4j:actionparam >" };
String[ ][ ] attributes = {{"type"},
{"ajaxOnly", "beanName"},
@@ -595,7 +595,7 @@
child.addChild(attributes[i][j], grandChild);
}
}
-...]]></programlisting>
+...</programlisting>
</section>
<section id="tsebro" role="updated">
@@ -716,23 +716,23 @@
<emphasis
role="bold">Example:</emphasis>
</para>
- <programlisting role="XML"><![CDATA[...
-<h:form>
- <rich:tree style="width:300px"
value="#{libraryAjaxTree.data}" nodeFace="#{item.type}"
var="item" dragIndicator=":treeDragIndicator"
dropListener="#{libraryAjaxTree.processDrop}">
- <rich:treeNode type="artist"
icon="/images/tree/group.png" iconLeaf="/images/tree/group.png"
acceptedTypes="album">
- <h:outputText value="#{item.name}" />
- </rich:treeNode>
- <rich:treeNode type="album" icon="/images/tree/cd.png"
iconLeaf="/images/tree/cd.png" dragType="album"
acceptedTypes="song">
- <h:outputText value="#{item.title}" />
- <rich:dndParam name="label" type="drag"
value="Album: #{item.title}" />
- </rich:treeNode>
- <rich:treeNode type="song" icon="/images/tree/music.png"
iconLeaf="/images/tree/music.png" dragType="song">
- <h:outputText value="#{item.title}" />
- <rich:dndParam name="label" type="drag"
value="Song: #{item.title}" />
- </rich:treeNode>
- </rich:tree>
-</h:form>
-...]]></programlisting>
+ <programlisting role="XML">...
+<h:form>
+ <rich:tree style="width:300px"
value="#{libraryAjaxTree.data}" nodeFace="#{item.type}"
var="item" dragIndicator=":treeDragIndicator"
dropListener="#{libraryAjaxTree.processDrop}">
+ <rich:treeNode type="artist"
icon="/images/tree/group.png" iconLeaf="/images/tree/group.png"
acceptedTypes="album">
+ <h:outputText value="#{item.name}" />
+ </rich:treeNode>
+ <rich:treeNode type="album"
icon="/images/tree/cd.png" iconLeaf="/images/tree/cd.png"
dragType="album" acceptedTypes="song">
+ <h:outputText value="#{item.title}" />
+ <rich:dndParam name="label" type="drag"
value="Album: #{item.title}" />
+ </rich:treeNode>
+ <rich:treeNode type="song"
icon="/images/tree/music.png" iconLeaf="/images/tree/music.png"
dragType="song">
+ <h:outputText value="#{item.title}" />
+ <rich:dndParam name="label" type="drag"
value="Song: #{item.title}" />
+ </rich:treeNode>
+ </rich:tree>
+</h:form>
+...</programlisting>
<para>This code renders following tree:</para>
@@ -946,5 +946,8 @@
<property><rich:tree></property>
</emphasis> usage and sources for the given example.
</para>
<para>How to Expand/Collapse Tree Nodes from code, see in
this<ulink
url="http://labs.jboss.com/wiki/ExpandCollapseTreeNodes">wiki
article</ulink>. </para>
+ <para>
+ Read <ulink
url="https://www.jboss.org/community/wiki/RichFacesTreeFAQ"> RichFaces Tree
FAQ </ulink> to know how to avoid problem with showing only two levels of node when
tree actually contains more.
+ </para>
</section>
</section>
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml 2009-09-10
11:20:36 UTC (rev 15523)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml 2009-09-10
11:58:32 UTC (rev 15524)
@@ -550,7 +550,10 @@
</listitem>
- </itemizedlist>
+ </itemizedlist>
+ <para>
+ Read <ulink
url="http://www.jboss.org/community/wiki/RichFacesinstallingandconfi...
installing and configuration"</ulink> article to find out how to integrate
RichFaces and Trinidad and possible problems that may occur while launching the RichFaces
sample on the JBoss server.
+ </para>
<para>Read also the <ulink
url="http://mkblog.exadel.com/?p=110">quick overview</ulink> to
"Practical RichFaces " book by Max Katz at his blog.</para>