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" 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>. + + 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==--