From richfaces-svn-commits at lists.jboss.org Thu Sep 10 07:58:33 2009
Content-Type: multipart/mixed; boundary="===============3930817890284106273=="
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: r15524 - in
branches/community/3.3.X/docs/userguide/en/src/main/docbook: modules and 1
other directory.
Date: Thu, 10 Sep 2009 07:58:32 -0400
Message-ID: <200909101158.n8ABwWQ5008976@svn01.web.mwc.hst.phx2.redhat.com>
--===============3930817890284106273==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
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/ric=
h_dataTable.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ric=
h_datascroller.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ric=
h_page.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ric=
h_tree.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCG=
ettingStarted.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/inclu=
ded/a4j_log.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4=
j_log.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4=
j_log.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -49,7 +49,7 @@
Example:
- ]]>
+ <a4j:log level=3D"ALL" popup=
=3D"false" width=3D"400" height=3D"200"/>
=
The component defined this way is decoded on a page as
@@ -107,5 +107,10 @@
Visit the Log page at RichFaces LiveDemo for exampl=
e of component usage and their sources.
+
+ You can find some cases when
+ <a4j:log>
+ might cause JavaScript error on Ajax Core Components P=
age. =
+
\ No newline at end of file
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/a4j_repeat.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4=
j_repeat.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4=
j_repeat.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -41,18 +41,18 @@
=
=
-
-
-
-
- |
- |
-
-
-
-
- ...]]>
+ ...
+<table>
+ <tbody>
+ <a4j:repeat value=3D"#{repeatBean.items}" var=3D"item" ajax=
Keys=3D"#{updateBean.updatedRow}">
+ <tr>
+ <td><h:outputText value=3D"#{item.code}" =
id=3D"item1" /></td>
+ <td><h:outputText value=3D"#{item.price}"=
id=3D"item2" /></td>
+ </tr>
+ </a4j:repeat>
+ </tbody>
+</table>
+ ...
=
The example above the
@@ -78,13 +78,13 @@
=
The next example shows collection output as a plain =
HTML list:
-
-
- ...
+ <ul>
+ <a4j:repeat ...>
+ <li>...<li/>
...
- ...
-
-]]>
+ <li>...<li/>
+ </a4j:repeat>
+</ul>
All other general attributes are defined accordi=
ng to the similar
attributes of iterative components (
<h:dataTable>
@@ -134,5 +134,11 @@
Visit the Repeat page =
at RichFaces LiveDemo for examples of component usage and their sources.
-
+ =
+
+ Here you can find information why you can'=
t use <a4j:repeat> to iterate the menuItems, tabs and way to solve this problem.
+
+
+ =
+
\ No newline at end of file
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/rich_dataTable.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_dataTable.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_dataTable.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -72,40 +72,40 @@
Example:
-
-
-
-
-
-
-
-
- State Flag
-
- State Flag
-
-
- State Name
-
- State Name
-
-
- State Capital
-
- State Capital
-
-
- Time Zone
-
- Time Zone
-
-
-
-
-
+ ...
+<rich:dataTable value=3D"#{capitalsBean.capitals}" var=3D"cap" rows=3D"=
5">
+ <f:facet name=3D"caption">
+ <h:outputText value=3D"United States Capitals" />
+ </f:facet>
+ <f:facet name=3D"header">
+ <h:outputText value=3D"Capitals and States Table" />
+ </f:facet>
+ <rich:column>
+ <f:facet name=3D"header">State Flag</f:facet>
+ <h:graphicImage value=3D"#{cap.stateFlag}"/>
+ <f:facet name=3D"footer">State Flag</f:facet>
+ </rich:column>
+ <rich:column>
+ <f:facet name=3D"header">State Name</f:facet>
+ <h:outputText value=3D"#{cap.state}"/>
+ <f:facet name=3D"footer">State Name</f:facet>
+ </rich:column>
+ <rich:column >
+ <f:facet name=3D"header">State Capital</f:facet>
+ <h:outputText value=3D"#{cap.name}"/>
+ <f:facet name=3D"footer">State Capital</f:facet>
+ </rich:column>
+ <rich:column>
+ <f:facet name=3D"header">Time Zone</f:facet>
+ <h:outputText value=3D"#{cap.timeZone}"/>
+ <f:facet name=3D"footer">Time Zone</f:facet>
+ </rich:column>
+ <f:facet name=3D"footer">
+ <h:outputText value=3D"Capitals and States Table" />
+ </f:facet>
+</rich:dataTable>
...
-]]>
+
=
This is a result:
=
@@ -328,5 +328,8 @@
From "rich:dataTable border to 0px " article you'll figure out how t=
o set rich:dataTable border to 0px
data=
Table Background Out tells you how to remove rich:dataTable header=
background
+
+ "Richfaces Datatable Checkbox" article helps you to create a =
Richface Datatable with Checkbox Column and an CheckAll Checkbox in Header.
+ =
\ No newline at end of file
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/rich_datascroller.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_datascroller.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_datascroller.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -108,16 +108,16 @@
Example:
-
-
-
-
-
-
-
-
-...]]>
+ ...
+<rich:datascroller for=3D"table" maxPages=3D"10">
+ <f:facet name=3D"first">
+ <h:outputText value=3D"First"/>
+ </f:facet>
+ <f:facet name=3D"last">
+ <h:outputText value=3D"Last"/>
+ </f:facet>
+</rich:datascroller>
+...
<emphasis role=3D"bold">
@@ -151,42 +151,42 @@
<para>
<emphasis role=3D"bold">Example:</emphasis>
</para>
- <programlisting role=3D"XML"><![CDATA[...
-<h:form id=3D"myForm">
- <rich:dataTable id=3D"carList" rows=3D"7" value=3D"#{dataTableScrollerBea=
n.allCars}" var=3D"category">
- <f:facet name=3D"header">
- <rich:columnGroup>
- <h:column>
- <h:outputText value=3D"Make" />
- </h:column>
- <h:column>
- <h:outputText value=3D"Model" />
- </h:column>
- <h:column>
- <h:outputText value=3D"Price" />
- </h:column>
- </rich:columnGroup>
- </f:facet>
- <h:column>
- <h:outputText value=3D"#{category.make}" />
- </h:column>
- <h:column>
- <h:outputText value=3D"#{category.model}" />
- </h:column>
- <h:column>
- <h:outputText value=3D"#{category.price}" />
- </h:column>
- </rich:dataTable>
- <rich:datascroller id=3D"sc2" for=3D"carList" reRender=3D"sc1" maxPages=
=3D"7" page=3D"#{dataTableScrollerBean.scrollerPage}" />
- <h:panelGrid>
- <h:panelGroup>
- <h:outputText value=3D"Set current page number:" />
- <h:inputText value=3D"#{dataTableScrollerBean.scrollerPage}" id=3D"sc1"=
size=3D"1"/>
- <h:commandButton value=3D"Set" />
- </h:panelGroup>
- </h:panelGrid>
-</h:form>
-...]]></programlisting>
+ <programlisting role=3D"XML">...
+<h:form id=3D"myForm">
+ <rich:dataTable id=3D"carList" rows=3D"7" value=3D"#{dataTableScroller=
Bean.allCars}" var=3D"category">
+ <f:facet name=3D"header">
+ <rich:columnGroup>
+ <h:column>
+ <h:outputText value=3D"Make" />
+ </h:column>
+ <h:column>
+ <h:outputText value=3D"Model" />
+ </h:column>
+ <h:column>
+ <h:outputText value=3D"Price" />
+ </h:column>
+ </rich:columnGroup>
+ </f:facet>
+ <h:column>
+ <h:outputText value=3D"#{category.make}" />
+ </h:column>
+ <h:column>
+ <h:outputText value=3D"#{category.model}" />
+ </h:column>
+ <h:column>
+ <h:outputText value=3D"#{category.price}" />
+ </h:column>
+ </rich:dataTable>
+ <rich:datascroller id=3D"sc2" for=3D"carList" reRender=3D"sc1" maxPage=
s=3D"7" page=3D"#{dataTableScrollerBean.scrollerPage}" />
+ <h:panelGrid>
+ <h:panelGroup>
+ <h:outputText value=3D"Set current page number:" />
+ <h:inputText value=3D"#{dataTableScrollerBean.scrollerPage}" id=3D"s=
c1" size=3D"1"/>
+ <h:commandButton value=3D"Set" />
+ </h:panelGroup>
+ </h:panelGrid>
+</h:form>
+...</programlisting>
=
<para> In the example above you can enter the page num=
ber you want and set it by
clicking on the <emphasis role=3D"bold">
@@ -232,32 +232,32 @@
<para>
<emphasis role=3D"bold">Example:</emphasis>
</para>
- <programlisting role=3D"XML"><![CDATA[...
-<h:form>
- <rich:dataTable value=3D"#{capitalsBean.capitals}" var=3D"cap" rows=3D"5">
- <rich:column>
- <h:outputText value=3D"#{cap.name}" />
- </rich:column>
- <f:facet name=3D"footer">
- <rich:datascroller pageIndexVar=3D"pageIndex" pagesVar=3D"pages">
- <f:facet name=3D"pages">
- <h:outputText value=3D"#{pageIndex} / #{pages}" />
- </f:facet>
- </rich:datascroller>
- </f:facet>
- </rich:dataTable>
-</h:form>
+ <programlisting role=3D"XML">...
+<h:form>
+ <rich:dataTable value=3D"#{capitalsBean.capitals}" var=3D"cap" rows=3D=
"5">
+ <rich:column>
+ <h:outputText value=3D"#{cap.name}" />
+ </rich:column>
+ <f:facet name=3D"footer">
+ <rich:datascroller pageIndexVar=3D"pageIndex" pagesVar=3D"pages">
+ <f:facet name=3D"pages">
+ <h:outputText value=3D"#{pageIndex} / #{pages}" />
+ </f:facet>
+ </rich:datascroller>
+ </f:facet>
+ </rich:dataTable>
+</h:form>
...
-]]></programlisting>
+</programlisting>
<para> It's possible to insert optional separators bet=
ween controls.
For this purpose use a <emphasis>
<property>"controlsSeparator"</pro=
perty>
</emphasis> facet. An example is placed belo=
w. </para>
- <programlisting role=3D"XML"><![CDATA[ ...
-<f:facet name=3D"controlsSeparator">
- <h:graphicImage value=3D"/image/sep.png"/>
-</f:facet>
-...]]></programlisting>
+ <programlisting role=3D"XML"> ...
+<f:facet name=3D"controlsSeparator">
+ <h:graphicImage value=3D"/image/sep.png"/>
+</f:facet>
+...</programlisting>
<para> Starting from 3.2.1 of RichFaces multiple <emph=
asis role=3D"bold">
<property><rich:datascroller>=
;</property>
</emphasis> instances behavior and page bind=
ings are corrected.
@@ -534,5 +534,14 @@
</emphasis> and <emphasis role=3D"bold">
<property><rich:datascroller>=
;</property>
</emphasis> in a context of Extended Data Mo=
del see on the <ulink url=3D"http://www.jboss.com/index.html?module=3Dbb&am=
p;op=3Dviewtopic&t=3D115636">RichFaces Users Forum</ulink>.</para>
+ <para>
+ <ulink url=3D"http://www.jboss.org/community/wiki/DataTablemodeldoe=
sntgetupdatedwhenrichdatascrollerused">This article</ulink> describes how t=
o solve <emphasis role=3D"bold"><property><rich:datatable></property>=
</emphasis> update problem when <emphasis role=3D"bold"><property><rich:=
datascroller></property></emphasis> used. =
+ </para>
+ <para>
+ <ulink url=3D"http://www.jboss.org/community=
/wiki/HowtousepairofrichdatascrollersoutsidetheanydataTable"> Here</ulink> =
you can find out how to use pair of <emphasis role=3D"bold"><property><r=
ich:datascrollers></property></emphasis> outside the any dataTable.
+ </para>
+ <para>
+ The solution about how to make <emphasis role=3D"bold"><property>&=
lt;rich:datascroller></property></emphasis> be updated after sorting/fi=
ltering can be found on <ulink url=3D"http://www.jboss.org/community/wiki/r=
ichdataScrollerisnotupdatedaftersortingfiltering">Data 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/inclu=
ded/rich_page.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_page.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_page.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -92,17 +92,17 @@
<emphasis role=3D"bold">Example:</emphasis>
</para>
=
- <programlisting role=3D"XML"><![CDATA[...
-<rich:page pageTitle=3D"The title of the page" markupType=3D"xhtml">
- <f:facet name=3D"pageHeader">
- <meta content=3D"The rich:page component" name=3D"keywords" />
- <link rel=3D"shortcut icon" href=3D"/images/favicon.ico" />
- <link href=3D"/css/style.css" rel=3D"stylesheet" type=3D"text/css" />
- <script type=3D"text/javascript" src=3D"/js/menu.js"></script>
- </f:facet>
- <!-- page content -->
-</rich:page>
-...]]></programlisting> =
=
=
=
+ <programlisting role=3D"XML">...
+<rich:page pageTitle=3D"The title of the page" markupType=3D"xhtml">
+ <f:facet name=3D"pageHeader">
+ <meta content=3D"The rich:page component" name=3D"keywords" />
+ <link rel=3D"shortcut icon" href=3D"/images/favicon.ico" />
+ <link href=3D"/css/style.css" rel=3D"stylesheet" type=3D"text/css" /&=
gt;
+ <script type=3D"text/javascript" src=3D"/js/menu.js"></script&g=
t;
+ </f:facet>
+ <!-- page content -->
+</rich:page>
+...</programlisting> =
=
=
=
<note>
<title>Note:
Note, the
@@ -125,20 +125,20 @@
=
=
=
-
-
-
-
-
-
-
-
-
-
-
-
-...]]> =
=
=
=
+ ...
+<rich:page sidebarPosition=3D"left" sidebarWidth=3D"300">
+ <f:facet name=3D"header">
+ <!-- header content -->
+ </f:facet>
+ <f:facet name=3D"sidebar">
+ <!-- side panel content -->
+ </f:facet>
+ <!-- body content -->
+ <f:facet name=3D"footer">
+ <!-- footer content -->
+ </f:facet>
+</rich:page>
+... =
=
=
=
The
<rich:page>
component also provides attributes to define CSS cla=
sses for each nested facet as well as a body part of the page created with =
the component.
@@ -286,5 +286,9 @@
<rich:page>
component usage and sources for the given exam=
ple.
The Layout components for RichFaces 3.3.1 on the JBoss.org Wiki
+
+ Refer to the "Changing the layout of the page dynamically"=
to find out how to change the layout of a page on the fly with
+ <rich:page>. =
+ =
\ No newline at end of file
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/rich_tree.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_tree.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ri=
ch_tree.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -93,7 +93,7 @@
<rich:tree>
is built from a simple
org.richfaces.model.TreeNode=
model:
- ...
private TreeNodeImpl<String> stationRoot =3D new TreeNodeImpl<Str=
ing>();
private TreeNodeImpl<String> stationNodes =3D new TreeNodeImpl<St=
ring>(); =
private String[] kickRadioFeed =3D { "Hall & Oates - Kiss On My List",
@@ -108,20 +108,20 @@
child.setData(kickRadioFeed[i]);
stationRoot.addChild(i, child);
}
-...]]>
+...
As it is mentioned before you need to pass
#{stations.stationNodes} property to the
"value"
attribute and define the
"var"
attribute in order to refer to t=
he data:
-
-
-
-
-
-...]]>
+ ...
+<rich:tree value=3D"#{stations.stationNodes}" var=3D"station">
+ <rich:treeNode>
+ <h:outputText value=3D"#{station}" />
+ </rich:treeNode>
+</rich:tree>
+...
This is a result:
A simple <emphasis role=3D"bold">
@@ -151,39 +151,39 @@
<property><rich:tree></prope=
rty>
</emphasis> from a local XML file. In the fo=
llowing example a simple
XML file (stations.xml) is used as a radio s=
tation playlist: </para>
- <programlisting role=3D"XML"><![CDATA[<?xml version=3D=
"1.0"?>
-<station name=3D"KickRadio">
- <feed date=3D"today">
- <song time=3D"07:00">Hall & Oates - Kiss On My List</song>
- <song time=3D"07:03">David Bowie - Let's Dance</song> =
- <song time=3D"07:06">Lyn Collins - Think (About It)</song>
- <song time=3D"07:10">Kim Carnes - Bette Davis Eyes</song>
- <song time=3D"07:15">KC & the Sunshine Band - Give It Up</song>
- </feed>
-</station>]]></programlisting>
+ <programlisting role=3D"XML"><?xml version=3D"1.0"?=
>
+<station name=3D"KickRadio">
+ <feed date=3D"today">
+ <song time=3D"07:00">Hall & Oates - Kiss On My List</song&=
gt;
+ <song time=3D"07:03">David Bowie - Let's Dance</song> =
+ <song time=3D"07:06">Lyn Collins - Think (About It)</song>
+ <song time=3D"07:10">Kim Carnes - Bette Davis Eyes</song>
+ <song time=3D"07:15">KC & the Sunshine Band - Give It Up</=
song>
+ </feed>
+</station></programlisting>
<para> Now you need to create a bean that holds a mode=
l nodes: </para>
- <programlisting role=3D"JAVA"><![CDATA[...
+ <programlisting role=3D"JAVA">...
private TreeNode data;
...
FacesContext context =3D FacesContext.getCurrentInstance();
data =3D XmlTreeDataBuilder.build(new InputSource(getClass().getResourceAs=
Stream("stations.xml")));
-...]]></programlisting>
+...</programlisting>
<para> Finally you should set the <emphasis>
<property>"value"</property>
</emphasis> attribute to the <code>data</cod=
e> bean property and
define the <emphasis>
<property>"var"</property>
</emphasis> attribute in order to refer to t=
he data of nodes: </para>
- <programlisting role=3D"XML"><![CDATA[...
-<rich:tree id=3D"treeXML" value=3D"#{stations.data}" var=3D"vardata">
- <rich:treeNode>
- <h:outputText value=3D"#{vardata.attributes['name']}" />
- <h:outputText value=3D"#{vardata.attributes['date']}" />
- <h:outputText value=3D"#{vardata.attributes['time']}" />
- <h:outputText value=3D" #{vardata.text}" />
- </rich:treeNode>
-</rich:tree>
-...]]></programlisting>
+ <programlisting role=3D"XML">...
+<rich:tree id=3D"treeXML" value=3D"#{stations.data}" var=3D"vardata">
+ <rich:treeNode>
+ <h:outputText value=3D"#{vardata.attributes['name']}" />
+ <h:outputText value=3D"#{vardata.attributes['date']}" />
+ <h:outputText value=3D"#{vardata.attributes['time']}" />
+ <h:outputText value=3D" #{vardata.text}" />
+ </rich:treeNode>
+</rich:tree>
+...</programlisting>
<para>This is a result:</para>
<figure>
<title>A simple <emphasis role=3D"bold">
@@ -220,21 +220,21 @@
<emphasis role=3D"bold">Example:</emphasis>
</para>
=
- <programlisting role=3D"XML"><![CDATA[...
-<h:form>
- <rich:tree style=3D"width:300px" value=3D"#{library.data}" var=3D"item=
" nodeFace=3D"#{item.type}">
- <rich:treeNode type=3D"artist" iconLeaf=3D"/images/tree/singer.png=
" icon=3D"/images/tree/singer.png">
- <h:outputText value=3D"#{item.name}" />
- </rich:treeNode>
- <rich:treeNode type=3D"album" iconLeaf=3D"/images/tree/disc.png" i=
con=3D"/images/tree/disc.png">
- <h:outputText value=3D"#{item.title}" />
- </rich:treeNode>
- <rich:treeNode type=3D"song" iconLeaf=3D"/images/tree/song.png" ic=
on=3D"/images/tree/song.png">
- <h:outputText value=3D"#{item.title}" />
- </rich:treeNode>
- </rich:tree>
-</h:form>
-...]]></programlisting>
+ <programlisting role=3D"XML">...
+<h:form>
+ <rich:tree style=3D"width:300px" value=3D"#{library.data}" var=3D"i=
tem" nodeFace=3D"#{item.type}">
+ <rich:treeNode type=3D"artist" iconLeaf=3D"/images/tree/singer.=
png" icon=3D"/images/tree/singer.png">
+ <h:outputText value=3D"#{item.name}" />
+ </rich:treeNode>
+ <rich:treeNode type=3D"album" iconLeaf=3D"/images/tree/disc.png=
" icon=3D"/images/tree/disc.png">
+ <h:outputText value=3D"#{item.title}" />
+ </rich:treeNode>
+ <rich:treeNode type=3D"song" iconLeaf=3D"/images/tree/song.png"=
icon=3D"/images/tree/song.png">
+ <h:outputText value=3D"#{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=3D"bold">Example:</emphasis>
</para>
- <programlisting role=3D"JAVA"><![CDATA[
+ <programlisting role=3D"JAVA">
nodeFace=3D"#{data.name !=3D 'param-value' ? 'artist' : 'album'}"
- ]]></programlisting>
+ </programlisting>
<para>There are some essential points in a <emphasis>
<property>"nodeFace"</property>
</emphasis> attribute usage: you need to def=
ine notions for
@@ -309,9 +309,9 @@
<para>
<emphasis role=3D"bold">Example:</emphasis>
</para>
- <programlisting role=3D"XML"><![CDATA[...
-<h:outputText value=3D"#{varAttributeName}">
-...]]></programlisting>
+ <programlisting role=3D"XML">...
+<h:outputText value=3D"#{varAttributeName}">
+...</programlisting>
<para>
<emphasis>
<property>"varAttributeName"</prop=
erty>
@@ -366,22 +366,22 @@
<emphasis role=3D"bold">Example:</emphasis>
</para>
=
- <programlisting role=3D"XML"><![CDATA[...
-<h:form>
- <rich:tree style=3D"width:300px" value=3D"#{library.data}" var=3D"item=
" nodeFace=3D"#{item.type}">
+ <programlisting role=3D"XML">...
+<h:form>
+ <rich:tree style=3D"width:300px" value=3D"#{library.data}" var=3D"i=
tem" nodeFace=3D"#{item.type}">
...
- <rich:treeNode type=3D"album" iconLeaf=3D"/images/tree/album.gif" =
icon=3D"/images/tree/album.gif"
- rendered=3D"#{item.exist}">
- <h:outputText value=3D"#{item.name}" />
- </rich:treeNode>
- <rich:treeNode type=3D"album" iconLeaf=3D"/images/tree/album_absen=
t.gif" icon=3D"/images/tree/album_absent.gif"
- rendered=3D"#{not item.exist}">
- <h:outputText value=3D"#{item.name}" />
- </rich:treeNode>
+ <rich:treeNode type=3D"album" iconLeaf=3D"/images/tree/album.gi=
f" icon=3D"/images/tree/album.gif"
+ rendered=3D"#{item.exist}">
+ <h:outputText value=3D"#{item.name}" />
+ </rich:treeNode>
+ <rich:treeNode type=3D"album" iconLeaf=3D"/images/tree/album_ab=
sent.gif" icon=3D"/images/tree/album_absent.gif"
+ rendered=3D"#{not item.exist}">
+ <h:outputText value=3D"#{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=3D"bold">Example:</emphasis>
</para>
=
- <programlisting role=3D"XML"><![CDATA[...
-<rich:tree value=3D"#{library.data}" var=3D"item">
+ <programlisting role=3D"XML">...
+<rich:tree value=3D"#{library.data}" var=3D"item">
...
- <f:facet name=3D"icon">
- <h:graphicImage value=3D"/images/tree/singer.png "/>
- </f:facet>
- <f:facet name=3D"iconCollapsed">
- <h:graphicImage value=3D"/images/tree/singer.png" />
- </f:facet>
- <f:facet name=3D"iconExpanded">
- <h:graphicImage value=3D"/images/tree/singer.png" />
- </f:facet>
- <f:facet name=3D"iconLeaf">
- <h:graphicImage value=3D"/images/tree/song.png" />
- </f:facet>
+ <f:facet name=3D"icon">
+ <h:graphicImage value=3D"/images/tree/singer.png "/>
+ </f:facet>
+ <f:facet name=3D"iconCollapsed">
+ <h:graphicImage value=3D"/images/tree/singer.png" />
+ </f:facet>
+ <f:facet name=3D"iconExpanded">
+ <h:graphicImage value=3D"/images/tree/singer.png" />
+ </f:facet>
+ <f:facet name=3D"iconLeaf">
+ <h:graphicImage value=3D"/images/tree/song.png" />
+ </f:facet>
...
-</rich:tree>
-...]]></programlisting>
+</rich:tree>
+...</programlisting>
=
<para> The <emphasis role=3D"bold">
<property><rich: tree></prop=
erty>
@@ -566,17 +566,17 @@
<emphasis role=3D"bold">Example:</emphasis>
</para>
=
- <programlisting role=3D"XML"><![CDATA[...
-<rich:tree value=3D"#{treeBean.data}" var=3D"node" switchType=3D"ajax" =
rowKeyConverter=3D"org.richfaces.TreeRowKeyConverter">
- <rich:treeNode ajaxSingle=3D"true">
- <h:outputText value=3D"#{node}"/>
- </rich:treeNode>
-</rich:tree>
-...]]></programlisting>
+ <programlisting role=3D"XML">...
+<rich:tree value=3D"#{treeBean.data}" var=3D"node" switchType=3D"ajax" =
rowKeyConverter=3D"org.richfaces.TreeRowKeyConverter">
+ <rich:treeNode ajaxSingle=3D"true">
+ <h:outputText value=3D"#{node}"/>
+ </rich:treeNode>
+</rich:tree>
+...</programlisting>
=
<para>In the example the tree uses the following data =
model:</para>
=
- <programlisting role=3D"JAVA"><![CDATA[...
+ <programlisting role=3D"JAVA">...
String[ ] components =3D {"< a4j:ajaxListener >", "< a4j:keepAliv=
e >", "< a4j:actionparam >" };
String[ ][ ] attributes =3D {{"type"},
{"ajaxOnly", "beanName"},
@@ -595,7 +595,7 @@
child.addChild(attributes[i][j], grandChild);
}
} =
-...]]></programlisting>
+...</programlisting>
=
</section>
<section id=3D"tsebro" role=3D"updated">
@@ -716,23 +716,23 @@
<emphasis role=3D"bold">Example:</emphasis>
</para>
=
- <programlisting role=3D"XML"><![CDATA[...
-<h:form>
- <rich:tree style=3D"width:300px" value=3D"#{libraryAjaxTree.data}" no=
deFace=3D"#{item.type}" var=3D"item" dragIndicator=3D":treeDragIndicator" d=
ropListener=3D"#{libraryAjaxTree.processDrop}">
- <rich:treeNode type=3D"artist" icon=3D"/images/tree/group.png" i=
conLeaf=3D"/images/tree/group.png" acceptedTypes=3D"album">
- <h:outputText value=3D"#{item.name}" />
- </rich:treeNode>
- <rich:treeNode type=3D"album" icon=3D"/images/tree/cd.png" iconL=
eaf=3D"/images/tree/cd.png" dragType=3D"album" acceptedTypes=3D"song">
- <h:outputText value=3D"#{item.title}" />
- <rich:dndParam name=3D"label" type=3D"drag" value=3D"Album:=
#{item.title}" />
- </rich:treeNode>
- <rich:treeNode type=3D"song" icon=3D"/images/tree/music.png" ico=
nLeaf=3D"/images/tree/music.png" dragType=3D"song">
- <h:outputText value=3D"#{item.title}" />
- <rich:dndParam name=3D"label" type=3D"drag" value=3D"Song: =
#{item.title}" />
- </rich:treeNode>
- </rich:tree>
-</h:form>
-...]]></programlisting>
+ <programlisting role=3D"XML">...
+<h:form>
+ <rich:tree style=3D"width:300px" value=3D"#{libraryAjaxTree.data}"=
nodeFace=3D"#{item.type}" var=3D"item" dragIndicator=3D":treeDragIndicator=
" dropListener=3D"#{libraryAjaxTree.processDrop}">
+ <rich:treeNode type=3D"artist" icon=3D"/images/tree/group.png=
" iconLeaf=3D"/images/tree/group.png" acceptedTypes=3D"album">
+ <h:outputText value=3D"#{item.name}" />
+ </rich:treeNode>
+ <rich:treeNode type=3D"album" icon=3D"/images/tree/cd.png" ic=
onLeaf=3D"/images/tree/cd.png" dragType=3D"album" acceptedTypes=3D"song">
+ <h:outputText value=3D"#{item.title}" />
+ <rich:dndParam name=3D"label" type=3D"drag" value=3D"Alb=
um: #{item.title}" />
+ </rich:treeNode>
+ <rich:treeNode type=3D"song" icon=3D"/images/tree/music.png" =
iconLeaf=3D"/images/tree/music.png" dragType=3D"song">
+ <h:outputText value=3D"#{item.title}" />
+ <rich:dndParam name=3D"label" type=3D"drag" value=3D"Son=
g: #{item.title}" />
+ </rich:treeNode>
+ </rich:tree>
+</h:form>
+...</programlisting>
=
<para>This code renders following tree:</para>
=
@@ -946,5 +946,8 @@
<property><rich:tree></prope=
rty>
</emphasis> usage and sources for the given =
example. </para>
<para>How to Expand/Collapse Tree Nodes from code, see=
in this<ulink url=3D"http://labs.jboss.com/wiki/ExpandCollapseTreeNodes">w=
iki article</ulink>. </para>
+ <para>
+ Read <ulink url=3D"https://www.jboss.org/community/wiki/RichFacesTre=
eFAQ"> RichFaces Tree FAQ </ulink> to know how to avoid problem with showin=
g 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/modul=
es/RFCGettingStarted.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFC=
GettingStarted.xml 2009-09-10 11:20:36 UTC (rev 15523)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/modules/RFC=
GettingStarted.xml 2009-09-10 11:58:32 UTC (rev 15524)
@@ -550,7 +550,10 @@
</listitem>
=
=
- </itemizedlist>
+ </itemizedlist>
+ <para>
+ Read <ulink url=3D"http://www.jboss.org/community/wiki/RichFacesinstal=
lingandconfiguration">"RichFaces installing and configuration"</ulink> arti=
cle to find out how to integrate RichFaces and Trinidad and possible proble=
ms that may occur while launching the RichFaces sample on the JBoss server.=
=
+ </para>
<para>Read also the <ulink url=3D"http://mkblog.exadel.com/?p=
=3D110">quick overview</ulink> to "Practical RichFaces " book by Max Katz a=
t his blog.</para>
=
=
--===============3930817890284106273==--