From richfaces-svn-commits at lists.jboss.org Fri Jul 10 12:05:41 2009
Content-Type: multipart/mixed; boundary="===============3432455907700140166=="
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: r14893 -
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included.
Date: Fri, 10 Jul 2009 11:48:33 -0400
Message-ID: <200907101548.n6AFmXFv022323@svn01.web.mwc.hst.phx2.redhat.com>
--===============3432455907700140166==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Author: atsebro
Date: 2009-07-10 11:48:33 -0400 (Fri, 10 Jul 2009)
New Revision: 14893
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/act=
ionparam.desc.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/act=
ionparam.xml
Log:
RF-7478: a4j:actionparam component description review =
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/actionparam.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ac=
tionparam.desc.xml 2009-07-10 13:52:02 UTC (rev 14892)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ac=
tionparam.desc.xml 2009-07-10 15:48:33 UTC (rev 14893)
@@ -1,25 +1,16 @@
-
-
- a4j:actionparam
-
-
- Description
- The
- <a4j:actionparam>
- component combines the functionality of both JSF compone=
nts:
- <f:param>
- and
- <f:actionListener>
- .
- More information about
- <f:param>
- and
- <f:actionListener>
- can be found in Sun JSF TLD documentation.
+
+
+ a4j:actionparam
+
+
+ Description
+
+ The <a4j:actionparam><=
/property> component combines the functionality of both JSF <f:param> and <f:actionListener> =
+ and allows to assign the value to the property of the manager =
bean directly using the assignTo =
attribute.
+
+
-
+
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/actionparam.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/ac=
tionparam.xml 2009-07-10 13:52:02 UTC (rev 14892)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/ac=
tionparam.xml 2009-07-10 15:48:33 UTC (rev 14893)
@@ -30,7 +30,7 @@
- Creating on a page
+ Creating the Component with a Page Tag
Simple component definition example:
Example:
@@ -48,28 +48,27 @@
...
]]>
-
- Key attributes and ways of usage
- The component
- <a4j:actionparam>
- is a combination of the functionality of two JSF t=
ags:
- <f:param>
- and
- <f:actionListener>
- .
- At the render phase, it's decoded by parent component (=
- <h:commandLink>
- or like) as usual. At the process request phase, i=
f the parent component
- performs an action event, update the "=
;value" specified in the &qu=
ot;assignTo"
- attribute as its "value". If a "converter"=
emphasis> attribute is specified, use it to encode and
- decode the "value" to a string stored in the html parameter. =
- To make the "assignTo" attribute usable add the actionParam
instance t=
o the parent component as an action listener.
-
- <a4j:actionparam>
- has a "noEscape" attribute. If it is set to
- "true", the "value" is evaluated as a JavaScript code.=
+ =
+ =
+ =
+ =
+
+ Details of usage
+
+ The component <a4j:actio=
nparam> is a combination of the functionality of t=
wo JSF tags: =
+ <f:param><=
/emphasis> and <f:actionListener>=
property>.
+
+ At the render phase, it's decoded by parent component (=
<h:commandLink> or like) as usual. =
+ At the process request phase, if the parent component perfor=
ms an action event, update the "value" specified in the =
+ "assignTo"attribute as its "value". =
+ If a "converter" attribute is specified, use it to encode and decode the =
"value" to a string stored in the=
html parameter. =
+ To make the "assignTo" attribute usable add the actionParam
instance t=
o the parent component as an action listener.
+
- Example:
+ <a4j:actionparam>
has a "noEscape" attribute. =
+ If it is set to "true", the <=
emphasis>"value" is evaluated as =
a JavaScript code.
+
+ Example:
@@ -81,20 +80,23 @@
...]]>
- The <a4j:param> extends =
- <f:param>, so the "name" attri=
bute is mandatory.
- Otherwise, the "value" misses due missing the request parameter name for it.
+ The <a4j:param><=
/emphasis> extends <f:param>, =
+ so the "name" a=
ttribute is mandatory. =
+ Otherwise, the "value" misses due missing the request parameter name for it.
=
=
Relevant resources links
-
- On the component LiveDemo page
- you can see the example of <a4j:actionparam> usage an=
d sources for the given example. =
-
- More information can be found on the Ajax4jsf Users Forum. =
+
+ Vizit the ActionParamter page at RichFaces LiveDemo for examples of component usage abd their sources. =
+
+
+ More information can be found on the Ajax=
4jsf Users Forum.
+ =
+
+ More information about <=
;f:param> and &l=
t;f:actionListener>can be found in Sun =
JSF TLD documentation.
+
+ =
=
--===============3432455907700140166==--